總覽
Google Play 管理中心提供一組 REST 式網路服務 API,可讓您直接為應用程式執行發布作業、製作報表和其他應用程式管理功能。
並非所有開發人員都必須採用這些開發人員 API;在多數情況下,您可以繼續使用 Google Play 管理中心直接管理應用程式。不過,如果需要管理大量 APK,或是需要追蹤使用者購買交易和訂閱,這些 API 便非常實用。
隨附內容
Google Play Developer API 可讓您專注於設計及開發應用程式,即使在拓展新市場時,依然無需花費時間與心力來管理版本。
Google Play 管理中心提供一組用於管理應用程式的 API:
- Publishing API 可讓您上傳及發布應用程式,並執行其他發布相關工作。
- Subscriptions and In-App Purchases API 可讓您管理應用程式內購和訂閱 (這個 API 舊稱為「Purchase Status API」)。
- Reporting API 可讓您從 Android Vitals 擷取應用程式品質的相關資訊。
- Reply to Review API 可讓您擷取及回覆應用程式的評論。
- Permissions API 可讓您透過 Play 管理中心自動管理權限。
- Play Games Services Management API 可讓您發出 REST 呼叫,透過程式輔助方式控制 Google Play 遊戲服務功能的基礎中繼資料。
- Voided Purchases API 提供與使用者作廢的購買交易相關的訂單清單。
開始使用
如要開始使用 Google Play Developer API,請參閱入門說明文件。
Publishing API
您可以透過 Publishing API 自動進行與應用程式發布相關的常態工作,其中包括類似開發人員可以在 Play 管理中心使用的功能,例如:
- 上傳新版本的應用程式
- 透過將 APK 指派至各種測試群組 (Alpha 版、Beta 版、階段推出版本或正式版) 來發布應用程式
- 建立及修改 Google Play 商店資訊,包括本地化文字、圖片、多裝置螢幕截圖
這些工作透過編輯功能執行,而此功能會透過事務管理方法進行變更。這樣就能將多項變更合併為單一草稿,然後一次提交所有變更 (這些變更要等到編輯作業提交後才會生效)。
最佳做法
- 限制應用程式更新的次數。發布 Alpha 版或 Beta 版更新的頻率不要超過每天一次 (正式版應用程式的更新頻率應該更低)。每次更新都會耗費使用者的時間,甚至可能會讓他們花費金錢。如果您的更新頻率過高,使用者可能會開始忽略更新,甚至解除安裝產品。
Subscriptions and In-App Purchases API
Subscriptions and In-App Purchases API 可讓您管理應用程式內產品和訂閱項目的應用程式目錄。此外,透過 Subscriptions and In-App Purchases API,您還能使用標準 GET
要求,快速擷取任何購買交易的詳細資料。
在這類要求中,您需要提供購買交易相關資訊,包括應用程式套件名稱、購買或訂閱 ID,以及購買憑證。伺服器會透過 JSON 物件回應,說明相關購買交易詳細資料、訂單狀態、開發人員酬載及其他資訊。
這個 API 的用途非常多樣,例如可以製作個別訂單的報表及進行對帳,以及驗證購買交易和訂閱效期。您也可以透過這個 API 瞭解已取消的訂單,並確認應用程式內產品是否已消耗 (包括是否在遭到取消前已消耗)。
最佳做法
- 將訂閱資訊儲存在伺服器上,藉此避免進行不必要的 API 呼叫。如果應用程式需要驗證訂閱,您應該依賴伺服器上的快取資訊,而不是重複向 Google 發出 API 呼叫。
- 在以下兩種情況中,您的安全伺服器應使用 Google Play Developer API 取得訂閱資訊:
- 您的伺服器收到從未看過的新購買憑證。
- 您的伺服器收到即時開發人員通知 (RTDN),指示您必須使用購買憑證來取得新的訂閱資訊。
- 請勿透過定期輪詢 API 的方式取得訂閱狀態。例如,請不要每天呼叫 API 來檢查每個訂閱項目。
- 您會在訂閱到期或續訂時收到 RTDN,因此不需要根據預定的到期時間安排 API 呼叫。
Reporting API
Reporting API 專為開發人員打造,可讓您以 Play 管理中心資料為基礎建立自動化工作流程,或是運用 Play 管理中心資料製作內部業務報表和分析數據 (可能與其他資料集搭配使用)。您可透過程式輔助的方式存取應用程式層級資料和指標,以建立內部報表、分析和自動化作業。
Reporting API 提供 Android Vitals 資料的存取權,包括當機率、ANR 發生率、喚醒和 Wake Lock 問題,以及錯誤堆疊追蹤。
最佳做法
Reply to Reviews API
Reply to Review API 可讓您查看及回覆應用程式的使用者意見回饋。您可以使用這個 API,直接在客戶關係管理系統等現有客戶服務工具包中與使用者互動。
Reply to Review API 只能讓您存取正式版應用程式的意見回饋。如果您想查看 Alpha 版或 Beta 版應用程式的意見回饋,請改用 Google Play 管理中心。另請注意,這個 API 只會顯示包含留言的評論。如果使用者對應用程式進行評分但並未提供留言,您就無法透過這個 API 存取他們的意見回饋。
Permissions API
Permissions API 可讓開發人員透過 Play 管理中心自動管理權限。這樣一來,您就能靈活控管有權存取您開發人員帳戶的使用者,不必手動操作。
透過 Permissions API,您可以執行各項管理功能,例如:
- 在使用者離職時移除他們的存取權。
- 當使用者加入應用程式團隊時,授予相關存取權。
Voided purchases API
Voided Purchases API 提供與使用者作廢的購買交易相關的訂單清單。您可以利用這份清單中的資訊實作撤銷系統,以防止使用者存取這些訂單中的產品。
這個 API 適用於一次性應用程式內訂單和應用程式訂閱項目。
購買交易的作廢方式如下:
- 使用者申請訂單退款。
- 使用者取消訂單。
- 訂單遭到拒付。
- 開發人員取消訂單或退款。注意:Voided Purchases API 只會顯示已撤銷的訂單。如果開發人員進行退款但未設定撤銷選項,訂單就不會顯示在 API 中。
- Google 取消訂單或退款。
使用這個 API 後,您就能為應用程式的所有使用者打造更和諧且公平的體驗,特別是在應用程式是遊戲的情況下。