Skip to content

USAGE-google-play.md

Latest commit

 

History

History
95 lines (66 loc) · 4.3 KB

USAGE-google-play.md

File metadata and controls

95 lines (66 loc) · 4.3 KB

To download directly from the Google Play Store, you have two authentication options:

Option 1: Using OAuth Token (recommended for personal accounts)

First, obtain an OAuth token by visiting the Google embedded setup page and:

  • Open the browser debugging console to the Network tab
  • Log in
  • If the "Google Terms of Services" pop up, click I agree (there may be some delay afterwards)
  • Select the last request from accounts.google.com in the Network tab
  • Select the Cookies tab of this request
  • One of the response cookies is oauth_token
  • Copy the value field (it will start with oauth2_4/)

It can only be used once, in order to obtain the AAS token which can be used subsequently. To obtain this token:

apkeep -e 'someone@gmail.com' --oauth-token oauth2_4/...

An AAS token should be printed. You can use this to download an app:

apkeep -a com.instagram.android -d google-play -e 'someone@gmail.com' -t some_aas_token .

Option 2: Using AUTH Token (for token dispensers)

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:

apkeep -a com.instagram.android -d google-play -e 'dispenser_email@gmail.com' --auth-token 'ya29.a0...' --accept-tos .

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.

Device Configuration

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:

apkeep -a com.instagram.android -d google-play -o device=ad_g3_pro -e 'someone@gmail.com' -t some_aas_token .

Available devices are specified here.

To specify your own device properties file (e.g. one you've exported from Aurora Store's spoof manager):

apkeep -a com.instagram.android -d google-play -o device=default,device_properties_file=/path/to/device.properties .

Likewise, a separate timezone or locale can also be specified:

apkeep -a com.instagram.android -d google-play -o device=ad_g3_pro,locale=es_MX -e 'someone@gmail.com' -t some_aas_token .

Note that if the app you're downloading is region-locked and not available in your region, the locale and timezone changes alone will not let apkeep download it. In that case the download will fail with a Invalid app response error. To download a region-locked app you first need to bind it to your account by downloading it with an IP address from a region it's available in. After the first download, you can download the app from any region.

This option attempts to download a split APK if available, and falls back to the full APK:

apkeep -a hk.easyvan.app.client -d google-play -o split_apk=true -e 'someone@gmail.com' -t some_aas_token .

A full list of options:

  • device: specify a device profile as described above
  • device_properties_file: specify a custom device properties file
  • locale: specify a locale
  • timezone: specify a timezone
  • split_apk: when set to 1 or true, attempts to download a split APK
  • 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
  • include_additional_files: when set to 1 or true, attempts to download any additional obb expansion files for the app

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:

[google]
email = someone@gmail.com
aas_token = some_aas_token
# OR use auth_token instead of aas_token:
# auth_token = ya29.a0...

Optionally, the path to this ini file can be specified:

apkeep -a com.instagram.android -d google-play -i ~/path/to/some.ini .