在 Google Cloud 中管理 Play Games 服務專案設定

您有時可能需要直接透過 Google Cloud 查看和編輯 Play Games 服務專案。

常見情況包括：

  • 啟用專案的其他 API (例如，Google 雲端硬碟)。
  • 在 OAuth 2.0 對話方塊中，編輯遊戲的品牌宣傳資訊。
  • 檢視您的 API 配額及要求更多 API 配額 (如有必要)。
  • 針對您過去建立的用戶端 ID，編輯已授權的 URI 或 JavaScript 來源。

查看專案

如要查看 Google Cloud 中的專案：

  1. 在「設定」頁面 (依序點選「拓展使用者」>「Play 遊戲服務」>「設定與管理」>「設定」) 中，選取遊戲憑證。
  2. 前往「Authentication」部分，然後按一下「View in Google Cloud」。

調整 API 用量配額

您可以在 Google Cloud 中查看遊戲設定的 API 用量限制，以及已使用的配額量。您也可以為每位玩家個別設定限制，防止騷擾他人的使用者 (或容易發生問題的遊戲用戶端) 用光您的配額。

如要查看或變更專案的用量限制，或是想申請更多配額，請進行以下步驟：

  1. 確認您的專案已設有帳單帳戶。如果沒有，請先建立一個。
  2. 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面，從清單中選取 API。
  3. 如要查看及變更配額相關設定，請點選「配額」。如要查看用量統計資料，請點選「用量」。

請注意，系統會根據申請配額的用戶端 IP 位址判斷「使用者」。比方說，如果所有要求都來自同一個伺服器，系統可能會錯將這個伺服器標記為一名提出過多垃圾申請的使用者。如要避免這種情形，您可以在 API 端點要求中加上 userIp=x.x.x.x 引數。

如要進一步瞭解如何為每位使用者個別設定配額，請參閱「限制 API 用量」一文。

除了為個別使用者施加限制之外，Google Play Games 服務 API 也設有每日的應用程式端限制。一般來說，您不需要變更這價預先分配好的限制。不過，如果您預期用量會突然大幅提昇 (譬如即將推出活動)，您可以按一下「Request more」連結申請提高配額。

啟用其他 API

在 Play 管理中心建立用戶端 ID 時，您的專案會自動開啟 Google Play Games Services API。您可以透過 Google Cloud 啟用其他 Google API。

如果想為專案啟用 API，請按照以下步驟操作：

  1. 在 Google API 控制台中開啟 API 程式庫。按照系統說明選取專案，或建立新專案。API 程式庫會列出所有可用的 API，並按照產品系列及熱門程度分組。

  2. 如果清單裡找不到您想啟用的 API，請使用搜尋功能。

  3. 選取要啟用的 API，然後按一下「啟用」按鈕。

  4. 如果系統顯示提示，請啟用帳單功能。

  5. 如果系統顯示提示，請接受 API 的服務條款。

修改品牌資訊

如要修改 OAuth 2.0 對話方塊中的標題及標誌等遊戲品牌資訊，請在 Google Cloud 的同意畫面設定以下屬性。

如想設定專案的同意畫面，請按照以下步驟操作：

  1. 開啟 Play 管理中心的同意畫面頁面。按照系統說明選取專案，或建立新專案。
  2. 填寫表單，然後按一下「儲存」。

修改 OAuth 使用者類型

如果您使用個人測試帳戶在正式版 (「測試及發布」>「正式版」) 測試群組中進行測試，則必須在 Google Cloud 中將 OAuth 對象設定為「外部」。詳情請參閱「管理應用程式目標對象」。

修改用戶端 ID 相關屬性

如要修改 OAuth 2.0 用戶端 ID 相關屬性 (網頁應用程式的網頁來源和重新導向網址等)：

  1. 開啟 Play 管理中心，然後前往您的遊戲。
  2. 在「設定」頁面 (依序點選「拓展使用者」>「Play 遊戲服務」>「設定與管理」>「設定」) 中，選取遊戲憑證。
  3. 捲動到「Authentication」區段底部，然後按一下「View in Google Cloud」。
  4. 在 Google Cloud 中選取專案。
  5. 點選左側欄的「APIs & auth」。查看系統顯示的 API 清單，並確認 Google Play Games 服務 API 的狀態是「ON」。
  6. 點選左側欄的「Registered apps」。
  7. 展開 OAuth 2.0 用戶端 ID 區段，然後找到要編輯的屬性。

從現有雲端專案遷移 OAuth 用戶端

如要在 Google Cloud 中查看專案，請按照「查看專案」一文中的步驟操作。

如要設定 Play 遊戲服務，您必須使用專屬的 Google Cloud 專案。如果多款遊戲共用一個雲端專案，您必須將這些遊戲的 Android OAuth 用戶端遷移至獨立專案，確保設定正確無誤。

兩款遊戲共用一個 Google Cloud 雲端專案的概略檢視畫面
圖 1. 遊戲 1 和遊戲 2 共用 Google Cloud 雲端專案的範例

在上述範例中，遊戲 1 和遊戲 2 已在單一 Google 雲端專案中，為「使用 Google 帳戶登入」功能建立網頁和 Android 用戶端。我們需要將遊戲 2 的網頁和 Android 用戶端，從目前的舊版 Google 雲端專案移至新的目標 Google 雲端專案。

將遊戲 2 遷移至新的 Google Cloud 雲端專案 (高階檢視畫面)
圖 2. 將遊戲 2 用戶端遷移至新的目標 Google Cloud 專案

步驟 1：準備後端

切換前，您必須調整後端和用戶端，以同時處理新舊 Web 用戶端 ID。

  • 伺服器端設定：如果伺服器會驗證 ID 權杖中的網頁用戶端 ID，您必須更新伺服器端邏輯，同時支援舊版 Cloud 專案中舊用戶端發出的 ID 權杖，以及您需要在目標 Cloud 專案中產生新用戶端。
  • 用戶端設定：您的用戶端應用程式必須支援多個網頁用戶端 ID，才能在切換時使用新的網頁用戶端 ID 登入。你可以使用下列任一方法：
    • 在用戶端應用程式中內建 2 個網頁用戶端 ID，舊的用戶端 ID 過期時會切換至新的網頁用戶端 ID
    • 從伺服器動態取得最新的 Web 用戶端 ID，完成切換
  • 預先建立 Web 用戶端：您必須在目標專案中預先建立新的 Web 用戶端，以免在原子切換期間發生潛在延遲。

步驟 2：在正確的 Google Cloud 中設定新的網頁和 Android OAuth 用戶端

步驟 2.1：在目標 Google Cloud 專案中，為遊戲 2 建立新的網路 OAuth 用戶端：

Google Cloud UI，用於建立新的網頁 OAuth 用戶端 ID
圖 3. 建立新的網頁 OAuth 用戶端

步驟 2.2： 警告：修改 Android 用戶端會導致遊戲使用者無法透過「使用 Google 帳戶登入」功能登入遊戲，因此您必須在執行步驟 2.2 後立即執行步驟 2.3。建議同時開啟 2 個網頁，以盡量縮短修改和重新建立之間的時間間隔。

在舊版 Google 雲端專案中，將遊戲 2 的 Android 用戶端套件名稱變更為無效值，例如 com.noexist.none。

Google Cloud UI，用於變更 Android 用戶端套件名稱
圖 4 在舊版專案中變更 Android 用戶端的套件名稱

步驟 2.3：在目標 Google Cloud 專案中，立即為遊戲 2 建立新的 Android 用戶端，並使用遊戲 2 的 SHA-1 指紋和套件名稱：

Google Cloud 使用者介面，用於建立新的 Android OAuth 用戶端 ID
圖 5 在目標專案中建立新的 Android 用戶端

步驟 3：即時部署設定

在目標專案中成功建立新的 Android 用戶端後，請立即執行下列操作：

  • 重新導向用戶端：使用動態設定機制 (例如遠端設定)，立即切換用戶端應用程式，開始使用新的 Web 用戶端 ID。
  • 保留舊用戶端：保留舊的 OAuth 用戶端做為備援選項，以便在發生任何問題時，復原先前的 OAuth 用戶端登入方式。