發出 API 呼叫前,請先設定 Google Play 開發人員帳戶的 API 存取權。這項作業需要在 Google Play 管理中心和 Google Cloud 控制台中進行變更。下列操作說明將說明開始使用 Google Play Developer API 的必要步驟。
- 建立 Google Cloud 專案。
- 為 Google Cloud 專案啟用 Google Play Developer API。
- 設定具備適當 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,請按照下列步驟操作:
- 前往 Google Cloud Console 的 Google Play Developer API 頁面。
- 按一下「啟用」。
設定 OAuth 和服務帳戶
您必須使用 OAuth 用戶端或服務帳戶,設定 Google Play Developer API 的存取權。在多數情況下,您應使用服務帳戶存取 API。
服務帳戶必須在安全環境中使用,例如伺服器。 服務帳戶憑證必須妥善管理,以免洩漏給未獲授權使用 API 的人員。
如要代表個別使用者存取 API,請使用 OAuth 用戶端 ID。舉例來說,如果您的網站需要代表使用者從網路用戶端存取 Google Play Developer API,您可以使用用戶端 ID。系統會改用 Google 帳戶驗證使用者,而非服務帳戶。這樣一來,您就能代表使用者呼叫 API,同時確保服務帳戶憑證安全無虞。
- 服務帳戶:安全軟體服務會存取 API (最常見)
- OAuth 用戶端:使用者將存取 API
使用服務帳戶
您可以在 Google Play 管理中心建立服務帳戶。
- 前往 Google Cloud 控制台的「服務帳戶」頁面。
- 按一下「建立服務帳戶」,然後按照步驟操作。
- 前往 Google Play 管理中心的「使用者和權限」頁面。
- 按一下「邀請新的使用者」。
在電子郵件地址欄位中輸入服務帳戶的電子郵件地址,並授予執行操作的必要權限。
如要使用 Google Play 帳款服務 API,您必須授予下列權限:
- 查看財務資料、訂單和取消訂閱問卷回覆情形
- 管理訂單和訂閱項目
按一下「邀請使用者」。
此時,您應該可以透過服務帳戶存取 Google Play Developer API。詳情請參閱「針對伺服器對伺服器應用程式使用 OAuth 2.0」一文。
使用 OAuth 用戶端
藉由使用 OAuth 用戶端,您可以讓使用者以自己的憑證透過 API 執行操作。使用者只能執行 Google Play 管理中心「使用者和權限」頁面允許的操作內容。
建立 OAuth 用戶端之前,請先設定產品的品牌資訊。詳情請參閱「設定 OAuth 同意畫面」。
- 前往 Google Cloud 控制台的 OAuth 同意畫面頁面。
- 按照步驟建立 OAuth 同意畫面。
如要建立 OAuth 用戶端,請按照下列步驟操作:
其他資訊
請參考下列提示和訣竅,開始在 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。詳情請參閱「用戶端程式庫和程式碼範例」。