開始使用

開始發出 API 呼叫前,您必須先設定 Google Play 開發人員帳戶的 API 存取權。這包括 Google Play 管理中心和 Google Cloud 控制台中的變更。以下操作說明會說明開始使用 Google Play Developer API 所需的步驟。

  1. 建立 Google Cloud 專案。
  2. 為 Google Cloud 專案啟用 Google Play Developer API。
  3. 設定具有適當 Google Play 管理中心權限的服務帳戶,以存取 Google Play Developer API。

建立 Google Cloud 專案

如果您已有要使用的 Google Cloud 專案,可以略過這個步驟。

Google Cloud 控制台中建立專案。

如要進一步瞭解 Google Cloud 專案,請參閱「建立及管理專案」。

啟用 API

設定 Google Cloud 專案後,請為這項專案啟用 Google Play Developer API。

如何啟用 Google Play Developer API:

  1. 前往 Google Cloud 控制台的 Google Play Developer API 頁面
  2. 點選「啟用」。

設定 OAuth 和服務帳戶

您必須使用 OAuth 用戶端或服務帳戶設定 Google Play Developer API 的存取權。在大多數情況下,您應使用服務帳戶存取 API。

服務帳戶必須在安全的環境 (例如伺服器) 中使用。服務帳戶憑證必須妥善管理,不會透露給未獲授權使用 API 的任何使用者。

如果您需要代表個別使用者存取 API,則應使用 OAuth 用戶端 ID。舉例來說,如果網站需要代表使用者從網路用戶端存取 Google Play Developer API,您可以使用用戶端 ID。系統會使用 Google 帳戶 (而非服務帳戶) 驗證使用者。如此一來,您就能代表使用者執行 API 呼叫,而不會影響服務帳戶憑證。

  • 服務帳戶:安全無虞的軟體服務會存取 API (最常用)
  • OAuth 用戶端:使用者將存取 API

使用服務帳戶

您可以透過 Google Play 管理中心建立服務帳戶

  1. 前往 Google Cloud 控制台中的「服務帳戶」
  2. 按一下「建立服務帳戶」,然後按照步驟操作。
  3. 前往 Google Play 管理中心的「使用者和權限」頁面。
  4. 按一下「邀請新的使用者」
  5. 在電子郵件地址欄位中輸入服務帳戶的電子郵件地址,並授予執行動作所需的權限。

    如要使用 Google Play Billing API,您必須授予下列權限:

    • 查看財務資料、訂單和取消訂閱問卷回覆情形
    • 管理訂單和訂閱項目
  6. 按一下「邀請使用者」

此時,您應可透過服務帳戶存取 Google Play Developer API。詳情請參閱「針對伺服器對伺服器應用程式使用 OAuth 2.0」。

使用 OAuth 用戶端

您可以讓使用者透過 OAuth 用戶端,以自己的憑證使用 API 執行操作。使用者只能執行 Google Play 管理中心「使用者和權限」頁面允許的操作。

建立 OAuth 用戶端之前,您需要設定產品的品牌資訊。詳情請參閱「設定 OAuth 同意畫面」一文。

  1. 在 Google Cloud 控制台中,前往「OAuth 同意畫面」頁面。
  2. 按照步驟建立 OAuth 同意畫面。

如何建立 OAuth 用戶端:

  1. 在 Google Cloud 控制台中,前往「憑證」
  2. 依序按一下 [建立憑證] > [OAuth 用戶端 ID]。
  3. 選擇應用程式類型,然後按照說明操作。

其他資訊

您可以運用下列提示與秘訣,開始在 Google Play 使用 API。

取得開發人員 ID

部分 API 會要求您提供 Google Play 管理中心開發人員 ID。這是您在建立 Google Play 開發人員帳戶時指派的長串號碼。您可在 Google Play 管理中心內幾乎任何頁面的網址中找到開發人員 ID,例如「API 存取權」頁面。

舉例來說,請考慮使用 Google Play 管理中心網址:

https://play.google.com/console/developers/1234567890123456789/api-access

在上述網址中,開發人員 ID 為 1234567890123456789

注意:如果應用程式從某個 Google Play 開發人員帳戶轉移至另一個 Google Play 開發人員帳戶,與該應用程式相關聯的開發人員 ID 也會隨之變更。這表示轉移完成後,您必須在應用程式的 API 呼叫中,將開發人員 ID 用於新的 Google Play 開發人員帳戶。

專門 API

Google Play Developer API 包含數種特殊 API,可讓您在應用程式上執行特定類型的分析:

Reply to Reviews API
可讓您查看應用程式的使用者意見回饋及回覆這項意見回饋。
Voided Purchases API
允許使用者針對作廢的購買交易,撤銷相關的應用程式內商品存取權。

用戶端程式庫

我們提供了用戶端程式庫,方便您透過程式存取 REST API。詳情請參閱用戶端程式庫和程式碼範例