開始使用

發出 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 Console 的 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 帳款服務 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 開發人員帳戶轉移到另一個帳戶,與該應用程式相關聯的開發人員 ID 就會變更。也就是說,轉移完成後,您必須在該應用程式的 API 呼叫中,使用新 Google Play 開發人員帳戶的開發人員 ID。

專用 API

Google Play Developer API 包含多個專用 API,可讓您對應用程式執行特定類型的分析:

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

用戶端程式庫

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