您必須先為 Google Play 開發人員帳戶設定 API 存取權,才能開始進行 API 呼叫。這同時涉及 Google Play 管理中心和 Google Cloud Console 的變更。下列操作說明說明開始使用 Google Play Developer API 的四個步驟。
- 將開發人員帳戶連結至新的或現有的 Google Cloud 專案。
- 為已連結的 Google Cloud 專案啟用 Google Play Developer API。
- 為已連結 Google Cloud 專案中的 Google Play Developer API 授權 API 金鑰。
- 設定具備適當 Google Play 管理中心權限的服務帳戶,藉此存取 Google Play Developer API。
連結帳戶與專案
您必須先將 Google Play 開發人員帳戶連結至 Google Cloud 專案,才能存取 Google Play Developer API。在多數情況下,我們建議您建立新的 Google Cloud 專案,並指定 Google Play 開發人員帳戶,但您可以連結現有的專案。請注意,每個 Google Play 開發人員帳戶都只能連結至一個 Google Cloud 專案。如果您有多個 Google Play 開發人員帳戶中的應用程式,這些應用程式都必須共用相同的 Google Cloud 專案。
建立新專案
- 前往 Google Play 管理中心的 API 存取權頁面。
- 按一下「Create new project」(建立新專案)。
系統會自動建立 Google Cloud 專案並連結至您的 Google Play 開發人員帳戶。
使用現有專案
如果您已經是 Google Cloud Console 的使用者,則可按照下列步驟連結至現有的 Google Cloud 專案:
- 前往 Google Play 管理中心的 API 存取權頁面。
- 選擇要連結的專案。如果未列出您的專案,請確認您要在連結的 Google Cloud 專案中,將使用者帳戶指定為擁有者。
- 按一下「連結現有專案」。
啟用 API
設定已連結的 Google Cloud 專案後,您必須為這項專案啟用 Google Play Developer API。如要這麼做,您必須是 Google Cloud 專案的擁有者。
- 前往 Google Play 管理中心的 API 存取權頁面。
- 在「API」下方找到 Google Play Developer API,然後按一下「開啟」。
此操作會立即更新 Google Cloud 專案,變更會立即生效。
授權 API 金鑰
如要使用 API,您必須在連結的 Google Cloud 專案中取得 API 金鑰,且該金鑰有權使用 Google Play Developer API。請在 Google Play 管理中心進行相關設定。
設定 OAuth 和服務帳戶
您必須使用 OAuth 用戶端或服務帳戶來設定 Google Play Developer API 的存取權。在大部分情況下,您應使用服務帳戶來存取 API。
服務帳戶必須在安全伺服器 (例如您的伺服器) 中使用。 服務帳戶憑證必須受到安全管理,因此不會向未獲權使用 API 的任何人員公開。
如果您需要代表個別使用者存取 API,請使用 OAuth 用戶端 ID。例如,如果您的網站需要代表網路用戶端存取 Google Play Developer API,您可以使用用戶端 ID。系統將使用 Google 帳戶 (而非服務帳戶) 來驗證使用者。這可讓您在代表不影響 API 憑證的情況下,代表使用者發出 API 呼叫。
- 服務帳戶:安全的軟體服務會存取 API (最常用)
- OAuth 用戶端:使用者可以存取這個 API
使用服務帳戶
您可以透過 Google Play 管理中心建立服務帳戶。
- 前往 Google Play 管理中心的 API 存取權頁面。
- 在「Service accounts」(服務帳戶) 下方,瞭解如何瞭解如何建立服務帳戶。
按照操作說明建立服務帳戶。
建立帳戶時,您必須授予服務帳戶 Google Cloud 專案的存取權,該帳戶才會顯示在 Google Play 管理中心。
在 Google Play 管理中心建立服務帳戶後,按一下「完成」。「API access」(API 存取權) 頁面的「Service Accounts」(服務帳戶) 部分會自動重新整理,並列出您的服務帳戶。
按一下「Grant Access」(授予存取權),提供服務帳戶執行操作必要的權限。
如要使用 Google Play Billing API,您必須授予下列權限:
- 查看財務資料、訂單和取消訂閱問卷回覆情形
- 管理訂單和訂閱項目
此時,您應該可透過服務帳戶存取 Google Play Developer API。詳情請參閱使用 OAuth 2.0 來進行伺服器對伺服器應用程式。
使用 OAuth 用戶端
您可以讓使用者使用 OAuth 用戶端,按照自己憑證下的 API 執行操作。只有使用者在 Google Play 管理中心的「使用者和權限」頁面上允許的操作才能執行這項操作。
建立 OAuth 用戶端之前,您必須先設定產品的品牌宣傳資訊。詳情請參閱設定 OAuth 同意畫面。
- 前往 Google Play 管理中心的 API 存取權頁面。
- 在「OAuth Clients」下方,按一下「Configure OAuth consent screen」。
- 設定產品的品牌宣傳資訊。
- 完成後,請按一下 [重新整理 OAuth 同意聲明]。這個專區會更新,您不會再看到有關品牌宣傳資訊的訊息。
如何使用 Google Play 管理中心建立 OAuth 用戶端:
- 前往 Google Play 管理中心的 API 存取權頁面。
- 在「OAuth Clients」下方,按一下「Create new OAuth client」。
- 按照網頁上的操作說明建立 OAuth 用戶端。
在 Google Play 管理中心建立 OAuth 用戶端後,請按一下「Done」(完成)。「API 存取權」頁面的「OAuth 用戶端」部分會自動重新整理,系統隨即會列出您的 OAuth 用戶端。
新的 OAuth 用戶端有時不會在頁面上立即顯示。在這種情況下,請按一下「Refresh OAuth client」。
本頁面的清單會顯示新 OAuth 用戶端的詳細資料。
其他資訊
下列提示和秘訣可協助您在 Google Play 上開始使用 API。
取得您的開發人員 ID
有些 API 會要求您提供 Google Play 管理中心開發人員 ID。這是您在建立 Google Play 開發人員帳戶時指派的長組數字。您可以在 Google Play 管理中心的幾乎所有頁面的網址 (例如 API 存取權頁面) 找到開發人員 ID。
以 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,可讓您針對應用程式執行特定類型的分析:
- 回覆 Review API
- 可讓您查看應用程式的使用者意見回饋,並回覆這項意見回饋。
- Voided Purchases API
- 允許使用者撤銷已作廢的應用程式內產品應用程式內產品存取權。
用戶端程式庫
我們提供用戶端程式庫,可讓您透過程式輔助的方式存取 REST API。詳情請參閱用戶端程式庫和程式碼範例。