Skip to content

USAGE-google-play.md

Latest commit

 

History

History
70 lines (50 loc) · 3.35 KB

USAGE-google-play.md

File metadata and controls

70 lines (50 loc) · 3.35 KB

To download directly from the Google Play Store, first you'll have to obtain an OAuth token by visiting the Google embedded setup page and:

  • Opening the browser debugging console on Network tab
  • Logging in
  • If the "Google Terms of Services" pop up, click I agree (it can hang up on this step but it's not important)
  • Select the last request from accounts.google.com in the Network tab
  • Select the Cookies tab of this request
  • One of the response cookie is oauth_token
  • Copy the value field (it must 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 .

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:

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.

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
  • 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/or AAS token:

[google]
email = someone@gmail.com
aas_token = some_aas_token

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

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