You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: USAGE-google-play.md
+21-3Lines changed: 21 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,8 @@
1
-
To download directly from the Google Play Store, first you'll have to obtain an OAuth token by visiting the Google [embedded setup page](https://accounts.google.com/EmbeddedSetup) and:
1
+
To download directly from the Google Play Store, you have two authentication options:
2
+
3
+
## Option 1: Using OAuth Token (recommended for personal accounts)
4
+
5
+
First, obtain an OAuth token by visiting the Google [embedded setup page](https://accounts.google.com/EmbeddedSetup) and:
2
6
3
7
- Open the browser debugging console to the `Network` tab
4
8
- Log in
@@ -20,7 +24,19 @@ An AAS token should be printed. You can use this to download an app:
20
24
apkeep -a com.instagram.android -d google-play -e 'someone@gmail.com' -t some_aas_token .
21
25
```
22
26
23
-
This will use a default device configuration of `px_9a`, a timezone of `UTC`, and a locale of `en_US`. To specify a different device profile, use the `-o` option:
27
+
## Option 2: Using AUTH Token (for token dispensers)
28
+
29
+
If you have an AUTH token from a token dispenser (e.g., Aurora Store's dispenser), you can use it directly with the `--auth-token` flag:
AUTH tokens typically start with `ya29.`. The `--accept-tos` flag is recommended for first-time use with a new account to automatically accept Google Play's Terms of Service.
36
+
37
+
## Device Configuration
38
+
39
+
Both options will use a default device configuration of `px_9a`, a timezone of `UTC`, and a locale of `en_US`. To specify a different device profile, use the `-o` option:
*`include_dex_metadata`: when set to `1` or `true`, attempts to download the DexMetadata (dm) file for an app, which contains the apps' cloud profile
63
79
*`include_additional_files`: when set to `1` or `true`, attempts to download any [additional `obb` expansion files](https://developer.android.com/google/play/expansion-files) for the app
64
80
65
-
If you prefer not to provide your credentials on the command line, you can specify them in a config file named `apkeep.ini`. This config file may have to be created, and must be located in the user config directory under the subpath `apkeep`. Usually on Linux systems this will be `~/.config/apkeep/apkeep.ini`. In this file specify your email and/or AAS token:
81
+
If you prefer not to provide your credentials on the command line, you can specify them in a config file named `apkeep.ini`. This config file may have to be created, and must be located in the user config directory under the subpath `apkeep`. Usually on Linux systems this will be `~/.config/apkeep/apkeep.ini`. In this file specify your email and token:
66
82
67
83
```ini
68
84
[google]
69
85
email = someone@gmail.com
70
86
aas_token = some_aas_token
87
+
# OR use auth_token instead of aas_token:
88
+
# auth_token = ya29.a0...
71
89
```
72
90
73
91
Optionally, the path to this `ini` file can be specified:
0 commit comments