總覽
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,您就能為應用程式的所有使用者打造更平衡公平的環境,特別是遊戲應用程式。