Google Play Developer API

Google Play Developer API 是一種 REST 式網路服務,可讓您執行發布和應用程式管理工作。您可以使用這個 API 將發布作業與版本管理流程整合。

並不是所有開發人員都必須採用這些 API;在多數情況下,您會繼續透過 Google Play 管理中心直接管理應用程式。 不過,如果需要管理大量 APK,或是需要追蹤使用者購買交易和訂閱,這個 API 便非常實用。

您可以透過 Google Play Developer API 自動執行多種應用程式管理工作,包括:

  • 上傳及發布新版本的應用程式
  • 編輯應用程式的 Google Play 商店資訊,包括本地化文字和圖片
  • 管理應用程式內產品目錄、產品購買狀態和應用程式訂閱

Google Play Developer API 可讓您專注在設計及開發應用程式上,同時減少花在版本管理上的時間和精力,即便您要拓展新市場也是如此。

Google Play Developer API 包含兩個元件:

Publishing API

您可以透過 Google Play Developer Publishing API 自動進行與應用程式發布相關的常態工作,其中包括與開發人員可透過 Play 管理中心使用的功能相似的功能,例如:

  • 上傳新版本的應用程式
  • 透過將 APK 指派至各種「測試群組」(Alpha 版、Beta 版、階段推出版本或正式版) 來發布應用程式
  • 建立及修改 Google Play 商店資訊,包括本地化文字、圖片、多裝置螢幕截圖

這些工作透過編輯功能執行,而此功能會透過事務管理方法進行變更,亦即將多項變更合併為單一草稿,然後一次提交所有變更 (這些變更在提交編輯之前不會生效)。

注意:並不是所有開發人員都必須使用這個 API,您也可以從 Google Play 管理中心取得 API 提供的所有功能。不過,透過這個 API,就能將應用程式和商店資訊更新流程與現有工具整合,對部分開發人員來說非常實用。特別是在有管理大量 APK 需求,或在許多不同地區都有提供本地化商店資訊時,就會發現這個 API 非常有用。

Subscriptions and In-App Purchases API

這個 API 可讓您管理應用程式的應用程式內產品和訂閱目錄。此外,透過 Subscriptions and In-App Purchases API,您還能使用標準 GET 要求,快速擷取任何購買交易的詳細資料。在這類要求中,您需要提供購買交易相關資訊,包括應用程式套件名稱、購買或訂閱 ID,以及購買憑證。伺服器會透過 JSON 物件回應,說明相關購買交易詳細資料、訂單狀態、開發人員酬載及其他資訊。

Purchase Status API 的用途非常多樣,例如可以針對個別訂單製作報表及對帳,以及驗證購買交易和訂閱效期。您也可以透過這個 API 瞭解已取消的訂單,並確認應用程式內產品是否已消耗 (包括是否在遭取消前消耗)。

注意:Subscriptions and In-App Purchases API 不會使用 Publishing API 所用的新事務管理型「編輯」功能。InappproductsPurchases.productsPurchases.subscriptions 資源的方法會立即生效。每個資源的 API 參考資料頁面都會明確註記該資源的方法是否採用「編輯」模型。

Purchase Status API 屬於 Google Play Developer API 2.0 版的一部分,您可以透過 Google Developers Console 取得。

使用 API

如要開始發起 API 呼叫,請直接透過 Google Play 管理中心設定及管理 Google Play Developer API。只有 Google Play 開發人員帳戶的擁有者可以管理這個 API。

如要存取 API,您必須:

  1. 設定新的或現有的 API 專案
  2. 設定一或多個授權用戶端,可以是下列任一形式:

詳情請參閱 Google Play Developer API 入門指南頁面。

分階段編輯

您可以透過 Google Play Developer Publishing API 的編輯方法準備並提交對 Google Play 應用程式的變更。在準備好更新後,只需單一操作即可部署更新。您可以進行的變更包括:

  • 上傳一或多個 APK
  • 將不同 APK 指派至不同「測試群組」(Alpha 版、Beta 版、階段推出版本和正式版)
  • 建立及修改應用程式的本地化商店資訊
  • 上傳應用程式商店資訊的螢幕截圖和其他圖片

分階段完成所有要進行的變更後,只需單一操作即可全部提交。

如需分階段編輯功能的完整資訊,請參閱 Google Play Developer API 編輯頁面。

注意:只有 Publishing API 可以使用新的事務管理型「編輯」功能。Subscriptions and In-App Purchases API 的方法會立即生效。每個資源的 API 參考資料頁面都會明確註記該資源的方法是否採用「編輯」模型。

有效率地使用 API

Google Play Developer API 的存取權受到限制,這有助於確保能為使用該 API 的所有應用程式創造高效能環境 (如配額中所述)。儘管您可以要求提高應用程式的每日配額,但我們強烈建議您運用下列技巧來盡量減少存取次數:

發布

  • 「限制應用程式更新的次數」:發布 Alpha 版或 Beta 版更新的頻率每天不要超過一次 (正式版應用程式的更新頻率應低於這個數字)。每次更新都會耗費使用者的時間,甚至可能會讓他們花費金錢。如果您的更新頻率過高,使用者就會開始忽略更新,甚至解除安裝產品 (當然,如果應用程式有重大問題,可以透過更新修正)。

一次性消費

  • 「僅針對新的購買交易查詢 Purchase Status API」:當有人購買時,您的應用程式可將購買憑證和其他詳細資料傳送至後端伺服器,而該伺服器可透過 Purchase Status API 驗證這筆購買交易。
  • 「在伺服器上快取購買交易詳細資料」:在可行範圍內,盡可能在後端伺服器上快取應用程式內產品和訂閱項目的購買交易詳細資料。如果應用程式在執行階段連線至後端伺服器來驗證購買交易有效性,伺服器就能根據快取資料驗證購買交易,從而盡可能減少使用 Purchase Status API,並為使用者提供最快速的回應 (和最佳體驗)。

訂閱

  • 將訂閱資訊儲存在伺服器上,藉此避免進行不必要的 API 呼叫。如果應用程式需要驗證訂閱,您應該依賴伺服器上的快取資訊,而不是重複向 Google 發出 API 呼叫。
  • 在以下兩種情況中,您的安全伺服器應使用 Google Play Developer API 取得訂閱資訊:

    • 您的伺服器收到從未看過的新購買憑證。
    • 您的伺服器收到即時開發人員通知 (RTDN),指示您必須使用購買憑證來取得新的訂閱資訊。

    此外,也請注意下列各項:

    • 請勿透過定期輪詢 API 的方式取得訂閱狀態。例如,請不要每天呼叫 API 檢查每個訂閱。
    • 您會在訂閱到期或續訂時收到 RTDN,因此不需要根據預定的到期時間安排 API 呼叫。

只要遵循這些一般指南,您的實作就能為使用者提供最佳效能。

配額

您必須管理 Google Play Developer API 的配額。 詳情請參閱配額說明文件