如果 Google Cloud 雲端專案未連結至 Google Play 管理中心的應用程式，或 Play SDK 管理中心的 SDK，則 Google Play Integrity API 會對該專案的流量強制執行每天 10,000 次要求的限制。這項限制已在大多數 Google Cloud 雲端專案中生效。少數專案已提高配額，因此連結期限延長至 2027 年 2 月 16 日，在此之前完成連結即可。
本指南說明專案連結對配額的影響、如何將 Google Cloud 專案連結至應用程式或 SDK，並解答常見問題。
重點摘要
| 重要詳細資料 | 說明 |
|---|---|
| 強制執行日期 | 大部分專案已啟用。 2027 年 2 月 16 日：適用於已收到期限通知的專案。 |
| 政策 | 如果 Play Integrity API 要求來自未連結至應用程式或 SDK 的雲端專案，則每天最多只能提出 10,000 次要求，即使專案設定了更高的自訂配額也一樣。 |
| 受影響對象 | 應用程式和 SDK 每天提出超過 10,000 次要求，但使用的 Google Cloud 雲端專案未連結至該應用程式 (在 Play 管理中心) 或 SDK (在 Play SDK 管理中心)。 |
| 敬請採取行動 | 在 Google Play 管理中心將 Google Cloud 雲端專案連結至應用程式，或在 Google Play SDK 管理中心連結至 SDK。 |
| 超過配額時發生錯誤 | 如果每天未連結的要求超過 10,000 次，就會失敗並傳回錯誤 TOO_MANY_REQUESTS (錯誤代碼 -8)。 |
常見問題
問題 1：為什麼需要連結 Google Cloud 專案？
Play Integrity API 為每個 Google Cloud 雲端專案提供預設配額，每天可提出 10,000 次要求。如果開發人員需要更高的用量，可以申請提高配額。
為保護應用程式或 SDK，並防止未經授權的第三方耗盡配額，提高的每日配額僅限用於 Google Cloud 專案，且該專案必須在 Google Play 管理中心連結至應用程式，或在 Google Play SDK 管理中心連結至 SDK。
問題 2：如何在 Play 管理中心或 Play SDK 管理中心連結 Google Cloud 專案？
應用程式 (Google Play 管理中心)：
- 登入 Google Play 管理中心，選取您的應用程式。
- 在左側導覽選單中，前往「由 Google Play 保護」。
- 選取「Play Integrity API」旁邊的「開始」 (或「管理」)。
- 按一下「連結雲端專案」 (如果已有連結的專案，請按一下「新增專案」)。
- 選取或輸入要連結的 Google Cloud 專案編號，然後確認。
SDK (Google Play SDK 管理中心)：
- 登入 Google Play SDK 管理中心，選取您的 SDK。
- 在左側導覽選單中，前往「SDK 完整性」。
- 按一下「Play Integrity API」旁邊的「設定」。
- 按一下「連結雲端專案」 (如果已有連結的專案，請按一下「新增其他專案」)。
- 選取或輸入要連結的 Google Cloud 專案編號，然後確認。
必要權限：
- Play 管理中心 (應用程式)：您必須具備應用程式的「發布正式版、排除特定裝置及使用 Play 應用程式簽署功能」權限。
- Play SDK 管理中心 (適用於 SDK)：您必須具備 SDK 的「管理」權限。
- Google Cloud (兩者)：您必須具備目標 Google Cloud 專案的 serviceusage.services.enable 和 resourcemanager.projects.get 權限。
問題 3：如何確認 Cloud 專案已正確連結？
應用程式 (Google Play 管理中心)：
- 依序開啟「Google Play 管理中心」>「受 Play 保護」>「Play Integrity API」>「管理」。
- 查看「Project configuration」(專案設定) 部分。
- 確認列出的專案編號與呼叫 Play Integrity API 的編號相符。
SDK (Google Play SDK 管理中心)：
- 開啟 Google Play SDK 管理中心 >「SDK 完整性」>「設定」。
- 查看「Project configuration」(專案設定) 部分。
- 確認列出的專案編號與呼叫 Play Integrity API 的編號相符。
問題 4：如果我的應用程式或 SDK 不在 Google Play 上，該如何連結雲端專案？
只有在 Google Play 管理中心管理的應用程式，以及在 Google Play SDK 管理中心註冊的 SDK，才能連結 Google Cloud 專案。
如果應用程式只在 Google Play 以外的管道發行，或 SDK 未列在 Play SDK 管理中心，您就無法連結 Google Cloud 專案，Play Integrity API 流量也會受限於預設的每日 10,000 項要求。如要提高配額，請在 Google Play 發布應用程式，或在 Play SDK 管理中心註冊符合資格的 SDK，並連結雲端專案。
問 5：我可以連結多項 Google Cloud 專案，或在多個應用程式/SDK 之間共用一項專案嗎？
- 每個應用程式或 SDK 可連結多項專案：單一應用程式或 SDK 最多可連結五項 Google Cloud 專案。
- 一個專案用於多個應用程式：您可以在 Google Play 管理中心將同一個 Google Cloud 專案連結至多個應用程式。不支援將同一個 Google Cloud 雲端專案連結至多個 SDK，或同時連結至 SDK 和應用程式。
問題 6：如果我管理應用程式或 SDK，但 Google Cloud 專案擁有者是組織中的其他人，該怎麼辦？
如要完成連結，在 Play 管理中心 (或 Play SDK 管理中心) 執行操作的使用者，也必須具備 Google Cloud 專案的必要權限。您可以透過下列兩種方式之一進行協調：
- 方法 A：請有權管理 Google Cloud 專案 IAM 存取權的人員，暫時授予您的 Google 帳戶 serviceusage.services.enable 和 resourcemanager.projects.get 權限。連結後，日常作業就不再需要這些權限。
- 方法 B：將必要的控制台權限授予已具備 Google Cloud 雲端專案 serviceusage.services.enable 和 resourcemanager.projects.get 權限的團隊成員，讓他們執行連結步驟：
- 應用程式 (Play 管理中心)：授予應用程式「發布正式版、排除特定裝置及使用 Play 應用程式簽署功能」權限。
- SDK (Play SDK 管理中心)：授予 SDK 的「管理」權限。
問 7：如果未在 2027 年 2 月 16 日前連結 Cloud 專案，會怎麼樣？
2027 年 2 月 16 日後，如果應用程式或 SDK 使用未連結的 Google Cloud 專案傳送 Play Integrity API 要求：
- 每天最多 10,000 次要求：在預設基本配額內，要求仍會正常執行。
- 每日超過 10,000 次要求：未連結專案每日要求次數達到 10,000 次後，系統會拒絕要求並傳回錯誤
TOO_MANY_REQUESTS(錯誤代碼-8)。
即時自助修復：
如果應用程式或 SDK 在期限後因未連結雲端專案而收到 TOO_MANY_REQUESTS 錯誤，只要在 Play 管理中心或 Play SDK 管理中心連結缺少的 Google Cloud 雲端專案，即可解決問題。
問 8：我沒有使用 Play Integrity API，為什麼我會收到訊息，要求連結雲端專案？
您會收到這則通知，是因為您的 Google Cloud 雲端專案每天產生超過 10,000 個未連結的 Play Integrity API 要求。常見原因包括：
- 使用 Cloud 專案編號設定的程式庫或 SDK：部分程式庫會使用 Google Cloud 專案呼叫 Play Integrity API。如果應用程式或 SDK 使用這類程式庫，請在 Play 管理中心將該專案連結至應用程式，或在 Play SDK 管理中心連結至 SDK。
- 貴機構的其他應用程式或團隊：其他團隊可能在應用程式或 SDK 中使用這個 Google Cloud 專案。請與工程團隊確認，找出應用程式或 SDK，然後在 Play 管理中心或 Play SDK 管理中心連結專案。
- 未經授權的流量或已停用的整合：如果未經授權或複製的應用程式使用您的專案編號傳送要求，或您不再使用 API，則不需採取任何行動。讓每日 10,000 次未連結要求的上限生效，即可限制不必要的流量。
聯絡與支援
如果您對連結 Cloud 專案或管理 Play Integrity API 配額有任何疑問：
- Play Integrity 支援表單：與開發人員支援團隊聯絡
- Play 管理中心一般說明：Play 管理中心的說明中心