Skip to content

Latest commit

 

History

History
247 lines (167 loc) · 6.92 KB

README_ZH-TW.md

File metadata and controls

247 lines (167 loc) · 6.92 KB
Raw

Google Play API (Node.js 套件)

English | 繁體中文

偽裝成 Android 裝置登入帳號發送請求來訪問 Google Play！

PHP 版本：開發中

問題

如果發現任何 BUG，請在此回報：https://github.com/GoneToneStudio/node-google-play-api/issues

安裝

需要 Node.js 14.0.0 或更高版本。

使用 NPM

npm install @gonetone/google-play-api

取得 OAuth2 Token

  • 前往 https://accounts.google.com/EmbeddedSetup

  • 登入您的 Google 帳號

  • 按下我同意

  • 查看 Cookie

    查看 Cookie

  • 展開 accounts.google.com > Cookie，找到 "oauth_token" 點擊，複製 "oauth2_4/" 開頭的值

    取得 OAuth2 Token

取得您裝置的 GSF ID (Google Service Framework ID)

您可以至 Google Play 安裝 "裝置 ID" APP 取得您裝置的 GSF ID：https://play.google.com/store/apps/details?id=tw.reh.deviceid

請注意：

  • 您取得 GSF ID 的裝置會影響後續取得 APP 資料，如果您想取得資料的 APP 不支援您取得 GSF ID 的裝置，資料會是 null，所以請先確認 APP 是否支援您的裝置。
  • Android TV 無法直接從 Google Play 下載安裝 "Device ID" APP，不過您可以使用其他裝置安裝，然後將 APP 備份為 APK，最後將 APK 傳送到 Android TV 安裝。

使用方法

const { GooglePlayAPI } = require('@gonetone/google-play-api')

使用 GooglePlayAPI 物件

const gpAPI = new GooglePlayAPI("[email protected]", "您的裝置 GSF ID (Google Service Framework ID)")

設定 User-Agent (可選)

gpAPI.setUserAgent('User-Agent')

設定客戶端 ID (可選)

gpAPI.setClientID('am-android-asus')

設定 SDK 版本 (可選)

gpAPI.setSdkVersion(28)

設定國家代碼 (可選)

gpAPI.setCountryCode('tw')

設定語言代碼 (可選)

gpAPI.setLanguageCode('zh-TW')

取得 App 詳細信息

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const details = await gpAPI.appDetails('com.github.android')

  console.log(`Title: ${details.title}`)
  console.log(`Description Html: ${details.descriptionHtml}`)
  console.log(`Developer Name: ${details.details.appDetails.developerName}`)
  console.log(`Version Code: ${details.details.appDetails.versionCode}`)
  console.log(`Version String: ${details.details.appDetails.versionString}`)
  console.log(`Package Name: ${details.details.appDetails.packageName}`)
  console.log(`Share Url: ${details.shareUrl}`)
  
  console.log(details)
})

取得批量 App 詳細信息

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const bulkDetails = await gpAPI.bulkDetails('com.github.android', 'com.twitter.android', 'com.facebook.katana')
  console.log(bulkDetails)
})

App 搜尋

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const search = await gpAPI.search('GitHub')
  console.log(search)
})

取得下載資訊

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const downloadInfo = await gpAPI.downloadInfo('com.github.android')
  //const downloadInfo = await gpAPI.downloadInfo('com.github.android', 613) // 指定版本代碼

  console.log(downloadInfo)
})

取得下載 Apk 的網址

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const downloadApkUrl = await gpAPI.downloadApkUrl('com.github.android')
  //const downloadApkUrl = await gpAPI.downloadApkUrl('com.github.android', 613) // 指定版本代碼

  console.log(downloadApkUrl)
})

下載 Apk

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  await gpAPI.downloadApk('com.github.android', 'save_folder')
  //await gpAPI.downloadApk('com.github.android', 'save_folder', 613) // 指定版本代碼
})

取得拆分交付資料資訊

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const splitDeliveryDataInfo = await gpAPI.splitDeliveryDataInfo('com.supercell.clashofclans')
  //const splitDeliveryDataInfo = await gpAPI.splitDeliveryDataInfo('com.supercell.clashofclans', 1383) // 指定版本代碼

  console.log(splitDeliveryDataInfo)
})

取得下載拆分 Apk 的名稱和網址

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const downloadSplitApksNameAndUrl = await gpAPI.downloadSplitApksNameAndUrl('com.supercell.clashofclans')
  //const downloadSplitApksNameAndUrl = await gpAPI.downloadSplitApksNameAndUrl('com.supercell.clashofclans', 1383) // 指定版本代碼

  console.log(downloadSplitApksNameAndUrl)
})

下載拆分 Apks

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  await gpAPI.downloadSplitApks('com.supercell.clashofclans', 'save_folder')
  //await gpAPI.downloadSplitApks('com.supercell.clashofclans', 'save_folder', 1383) // 指定版本代碼
})

PS：

  • 您可以使用 Split APKs Installer (SAI) 這個 App 來安裝拆分的 Apks。
  • 別忘了使用 gpAPI.downloadApk() 下載主 Apk，再一同安裝。

取得附加文件資訊

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const additionalFileInfo = await gpAPI.additionalFileInfo('com.github.android')
  //const additionalFileInfo = await gpAPI.additionalFileInfo('com.github.android', 613) // 指定版本代碼

  console.log(additionalFileInfo)
})

取得下載附加文件的網址

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  const downloadAdditionalFileUrls = await gpAPI.downloadAdditionalFileUrls('com.github.android')
  //const downloadAdditionalFileUrls = await gpAPI.downloadAdditionalFileUrls('com.github.android', 613) // 指定版本代碼

  console.log(downloadAdditionalFileUrls)
})

下載附加文件

gpAPI.getGoogleToken('您的 OAuth2 Token', 'save/token.txt').then(async (token) => {
  await gpAPI.googleAuth(token)

  await gpAPI.downloadAdditionalFiles('com.github.android', 'save_folder')
  //await gpAPI.downloadAdditionalFiles('com.github.android', 'save_folder', 613) // 指定版本代碼
})

License

MIT