对于未在 Google Play 管理中心内关联到应用或未在 Play SDK 管理中心内关联到 SDK 的 Google Cloud 项目，Google Play Integrity API 会对其流量施加每天 10,000 次请求的限制。此限制已对大多数 Google Cloud 项目生效。对于少数已提高配额的项目，我们已将截止日期延长至 2027 年 2 月 16 日，以便这些项目在限制生效之前完成关联。
本指南介绍了项目关联对配额的影响、如何将 Google Cloud 项目关联到应用或 SDK，并解答了常见问题。
快速摘要
| 重要详情 | 说明 |
|---|---|
| 违规处置日期 | 对于大多数项目，此功能已启用。 对于收到截止日期通知的项目，截止日期为 2027 年 2 月 16 日。 |
| 政策 | 源自未关联到您的应用或 SDK 的云项目的 Play Integrity API 请求上限为每天 10,000 次请求，无论该项目上配置的自定义配额是否更高。 |
| 受影响的对象 | 应用和 SDK 使用未关联到该应用（在 Play 管理中心内）或 SDK（在 Play SDK 管理中心内）的 Google Cloud 项目，每天发出超过 10,000 个请求。 |
| 请采取行动 | 在 Google Play 管理中心内将 Google Cloud 项目关联到您的应用，或在 Google Play SDK 管理中心内将 Google Cloud 项目关联到您的 SDK。 |
| 超出配额时出错 | 每天超过 10,000 次的未关联请求会失败，并显示错误 TOO_MANY_REQUESTS（错误代码 -8）。 |
常见问题解答
Q1：为什么需要关联 Google Cloud 项目？
Play Integrity API 为每个 Google Cloud 云项目提供的默认配额为每天 10,000 次请求。需要更高调用量的开发者可以申请提高配额。
为保护您的应用或 SDK 并防止未经授权的第三方耗尽您的配额，增加的每日配额仅限在 Google Play 管理中心内与您的应用关联的 Google Cloud 项目或在 Google Play SDK 管理中心内与您的 SDK 关联的 Google Cloud 项目使用。
问题 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 管理中心 > Protected with Play > Play Integrity API > 管理。
- 查看“项目配置”部分。
- 确保列出的项目编号与用于调用 Play Integrity API 的项目编号一致。
对于 SDK（Google Play SDK 管理中心）：
- 依次打开 Google Play SDK 管理中心 > SDK 完整性 > 设置。
- 查看“项目配置”部分。
- 确保列出的项目编号与用于调用 Play Integrity API 的项目编号一致。
Q4：如果我的应用或 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，并关联您的云项目。
Q5: Can I link multiple Google Cloud projects, or share one project across apps or SDKs?
- 每个应用或 SDK 对应多个项目：您最多可以将五个 Google Cloud 项目关联到单个应用或 SDK。
- 一个项目对应多个应用：您可以在 Google Play 管理中心内将同一个 Google Cloud 项目关联到多个应用。不支持将同一 Google Cloud 项目关联到多个 SDK 或关联到一个 SDK 和一个应用。
Q6: 如果我负责管理应用或 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 的“管理”权限。
Q7：如果我在 2027 年 2 月 16 日之前未关联 Cloud 项目，会发生什么情况？
如果应用或 SDK 在 2027 年 2 月 16 日之后使用未关联的 Google Cloud 项目发送 Play Integrity API 请求，则：
- 每天最多 10,000 次请求：在默认基准配额下，请求会继续正常成功。
- 每天超过 10,000 次请求：一旦未关联的项目每天达到 10,000 次请求，请求就会被拒绝，并显示错误
TOO_MANY_REQUESTS（错误代码-8）。
即时自助修复：
如果您的应用或 SDK 在截止日期后因未关联云项目而收到 TOO_MANY_REQUESTS 错误，在 Play 管理中心或 Play SDK 管理中心内关联缺失的 Google Cloud 项目即可解决此问题。
Q8：我没有使用 Play Integrity API。为什么我收到了要求关联云项目的消息？
您收到此通知，是因为您的 Google Cloud 项目每天生成的未关联 Play Integrity API 请求超过 10,000 个。常见原因包括：
- 使用您的云项目编号配置的库或 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 管理中心帮助中心