2026 年 9 月 10 日，星期四
为了改善开发者入门和使用体验，我们在 Google Cloud 控制台中为 Google Ads API 构建了一个新首页。对于已完成品牌验证的开发者，基本访问权限申请现已实现自动化。这篇博文介绍了将于今天开始逐步推出的几项相关变更。开发者应查看本博文中的请采取行动部分，以确保顺利过渡。
API 访问管理变更
我们即将更新您注册和管理 Google Ads API 访问权限的方式。
Google Ads API 的全新新手入门体验：您现在可以直接在 Google Cloud 控制台中注册访问 Google Ads API，而无需 Google Ads 经理账号。我们将弃用经理账号“API 中心”页面中的所有新注册和 API 访问管理功能，并将其迁移到 Google Cloud 控制台中的 Google Ads API“概览”页面。您仍然可以访问 API 中心页面，查看旧版开发者详细信息。此页面日后将被完全弃用。
API 访问权限级别与 Google Cloud 项目相关联：我们将停用开发者令牌。根据近期的 API 活动，您当前使用的开发者令牌访问权限级别会自动转移到您的 Google Cloud 项目。您可以继续在 API 调用标头中发送开发者令牌，但这是可选的，并且会被 API 服务器忽略。您现有的代码无需任何更改即可继续运行。现在，您的 API 访问权限级别由您用于生成 OAuth 凭证的 Google Cloud 项目决定。如需详细了解本次变更并排查您可能遇到的任何问题，请参阅我们的常见问题解答页面。
新错误代码：如果您尝试使用具有测试账号访问权限级别的 Google Cloud 项目向生产账号发出调用，Google Ads API v25 版将抛出 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 错误。旧版 API 则会抛出 ACTION_NOT_PERMITTED 错误。如果您遇到此错误，请前往 Google Cloud 项目的 Google Ads API“概览”页面，然后申请 Explorer 访问权限。
API 审核流程变更
申请基本权限和标准权限时需要进行品牌验证：对于新的基本权限和标准权限申请，您必须为 Google Cloud 项目完成品牌验证。现有访问权限持有者无需完成品牌验证，但我们建议您完成。
基本访问权限申请自动审批：基本访问权限申请现已实现自动化，在品牌验证和提交后几分钟内即可完成审核。
一次性拒绝待处理的基本访问权限申请：由于这些流程更新，所有待处理的基本 API 访问权限申请都将在过渡期间关闭。受影响的申请人会收到一封电子邮件，其中包含详细信息，并应从 Google Ads API“概览”页面重新申请 API 访问权限。
需要采取行动
验证您的 API 访问权限：检查项目的 API 访问权限级别是否与您现有的开发者令牌正确匹配：
- 在 Google Ads 经理账号的 API 中心内，找到开发者令牌的访问权限级别。
- 在 Google Ads API“概览”页面上，确认您的 Google Cloud 项目具有相同的访问权限级别。
- 如果访问权限级别不一致，请通过 Google Ads API 概览页面重新申请 API 访问权限，或者在需要帮助时联系 Google Ads API 支持团队。
更新您的 API 联系邮箱：访问 Cloud 项目的 IAM（Identity and Access Management，即“身份和访问权限管理”）页面。确保拥有 Owner 和 Editor 角色的用户列表是最新的。我们将开始向这些邮箱发送重要服务通知 (MSA)，以便在 Google Ads API 日后发生任何变更时通知您。
代码更改：我们建议您更新应用代码，以便在 API 调用中停止发送开发者令牌。我们发布了新版客户端库，让您无需设置开发者令牌，就能进行 API 调用。在未来的 Google Ads API 主要版本中，我们将开始拒绝 API 调用中的开发者令牌。
重新申请 API 访问权限（如适用）：如果您的待处理基本 API 访问权限申请在此次过渡期间被关闭，请通过 Google Cloud 控制台的 Google Ads API“概览”页面重新申请 API 访问权限。
我们已发布更新后的文档，以帮助您应对这些变化。如有技术支持问题，请参阅我们的常见问题解答页面或联系 Google Ads API 支持团队。如果您有任何疑问或想讨论此帖子，请通过我们的 Google 广告和效果衡量社区 Discord 服务器与我们联系。
- Anash P. Google Ads API 团队 Oommen
标签： google-ads-api、 release