开发者令牌是一个包含 22 个字符的字母数字字符串，用于将您的应用连接到 Google Ads API。开发者令牌已于 2026 年 9 月 9 日弃用。本指南总结了相关变更，并列出了有关此迁移的常见问题，以帮助现有开发者。
有何变化？
随着开发者令牌的停用，我们对 Google Ads API 初始配置体验和 API 访问权限管理进行了一些更改。本部分重点介绍了主要变更。
API 访问权限级别与 Google Cloud 项目相关联
我们将于 2026 年 9 月 9 日弃用开发者令牌。根据近期的 API 活动，您当前有效的开发者令牌访问权限级别已自动转移到您的 Google Cloud 项目。您可以继续在 API 调用标头中发送开发者令牌，但这是可选操作，API 服务器会忽略这些令牌。您现有的代码将继续正常运行，无需进行任何更改。您的 API 访问权限级别现在由您用于生成 OAuth 凭据的 Google Cloud 项目决定。
Google Ads API 全新注册流程
您现在可以直接在 Google Cloud 控制台中申请 Google Ads API 访问权限，而无需拥有 Google Ads 经理账号。请勿在 Google Ads 经理账号的 API 中心页面中注册开发者令牌，也不要尝试在 API 中心页面中申请 API 访问权限，因为这些流程已迁移到 Google Cloud 控制台，如果从 API 中心页面发起，将不会得到处理。
全新的 API 访问权限管理体验
我们已在 Google Ads 经理账号的 API 中心页面中停用所有新的注册和 API 访问权限管理功能，例如申请 API 访问权限和管理 API 访问权限级别。这些功能现已在 Google Cloud 控制台中的 Google Ads API 概览页面中提供。
您仍然可以访问 API 中心页面，查看您的历史开发者详细信息。此页面日后将被完全弃用。
新错误代码
如果尝试使用具有测试访问权限的 Google Cloud 项目来调用生产账号，Google Ads API 的版本 v25 将抛出 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 错误。旧版 API 会改为抛出 ACTION_NOT_PERMITTED 错误。如果您遇到此错误，请前往 Google Cloud 项目的 Google Ads API 概览页面，然后申请 Explorer 访问权限。
基本访问权限和标准访问权限需要进行品牌验证
对于新的基本访问权限和标准访问权限申请，您必须为 Google Cloud 项目完成品牌验证。现有访问权限持有者无需完成品牌验证，但我们建议他们完成验证。
基本访问权限申请现在已实现自动化，在品牌验证和提交后几分钟内即可完成审核。
由于这些流程更新，所有待处理的基本访问权限申请都将在此过渡期间关闭。受影响的申请者将收到一封包含详细信息的电子邮件，应从 Google Ads API 概览页面重新申请基本访问权限。
新的 API 联系邮箱
随着我们准备停用 API 中心页面，我们将改用 Google Cloud 项目中的所有者和编辑者用户列表作为唯一的渠道来传达管理和强制性合规性方面的通知。为确保顺利过渡，我们将暂时继续向您的 API 中心内列出的电子邮件地址发送重要服务通知 (MSA)。在最终完成通信渠道的过渡后，我们会及时通知您。
如果您是现有开发者，该怎么做
查看 Google Cloud 项目的 API 访问权限级别：如果您是现有开发者，我们强烈建议您查看 Google Cloud 项目的 Google Ads API 概览页面，确保这些项目具有与现有开发者令牌相同的 API 访问权限级别。请按照本指南中的说明解决您可能发现的任何差异。
查看您的 API 联系电子邮件地址：访问 Google Cloud 项目的 IAM（身份和访问权限管理）页面。验证您的有效广告开发者和客户经理是否在 Google Cloud 项目中被分配了适当的所有者或编辑者角色。我们将开始向这些电子邮件地址发送强制性服务公告 (MSA)，以便在 Google Ads API 未来发生任何变化时通知您。在一段时间内，我们会继续向您的 API 中心中列出的联系电子邮件地址发送 MSA，并且会在此流程更新时通知您。
修复应用代码：我们建议您更新应用，停止在 API 调用中发送开发者令牌。我们发布了客户端库、Google Ads MCP 服务器和 Google Ads API 开发者助理的更新版本，让您无需设置开发者令牌即可进行 API 调用。在未来的 Google Ads API 主要版本中，我们将开始拒绝 API 调用中的开发者令牌。如果您的应用使用了这些库，请更新应用依赖项以使用最新版本。
如果您需要进一步的帮助或有更多问题，请与 Google Ads API 支持团队联系。
常见问题解答
API 访问权限级别会受到什么影响？
Google Ads API 仍会强制执行 API 访问权限级别。不过，这些权限现在会授予您的 Google Cloud 控制台项目，而不是您的开发者令牌。当您进行 API 调用时，您的 API 访问权限级别现在由您用于生成 OAuth 凭据的 Google Cloud 项目决定。
我们是如何确定要转移 API 访问权限级别的项目的？
如果您在 2026 年 9 月 9 日之前已拥有获批的开发者令牌，则该令牌的访问权限级别已转移到您的 Google Cloud 项目，具体如下：
- 我们检查了过去 90 天内的 API 调用日志，以确定哪些 Cloud 项目曾使用您获批的开发者令牌进行 API 调用。
- 我们已将开发者令牌的 API 访问权限级别分配给所有已识别的 Cloud 项目。
在此变更后，我可以拥有多个具有不同访问权限级别的 Cloud 项目吗？
可以，您可以拥有多个具有不同 API 访问权限级别的 Google Cloud 项目。例如，您可以拥有一个具有基本访问权限的 Google Cloud 项目，以及另一个具有标准访问权限的 Google Cloud 项目。
示例
举例来说，假设您有 4 个开发者令牌和 6 个 Cloud 项目，详细信息如下：
- 开发者令牌 1：
abcdefghijkl1234567890具有标准访问权限。已用于项目 ID：1234567890、5678912345、45678912345。 - 开发者令牌 2：
xyzabcdefghi6789012345具有基本访问权限。已与项目 ID1231235678搭配使用。 - 开发者令牌 3：
asdfgflkjhjz7654321012具有基本访问权限，但从未用于进行 API 调用。最近已获批。 - 开发者令牌 4：
qwertypoiuyu6543298790曾拥有标准访问权限，但在过去 90 天内未使用过。项目 ID9876564900之前曾与此开发者令牌搭配使用。 - Cloud 项目：Cloud 项目 ID：
7171234567从未使用任何开发者令牌进行 API 调用。
API 访问权限将从开发者令牌转移到 Google Cloud 项目，具体如下：
| 开发者令牌 | 项目 ID | 访问权限级别 | 说明 |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
“标准”权限 | 开发者令牌和项目 ID 相互关联。 |
abcdefghijkl1234567890 |
5678912345 |
“标准”权限 | 开发者令牌和项目 ID 相互关联。 |
abcdefghijkl1234567890 |
45678912345 |
“标准”权限 | 开发者令牌和项目 ID 相互关联。 |
xyzabcdefghi6789012345 |
1231235678 |
基础访问权限 | 开发者令牌和项目 ID 相互关联。 |
asdfgflkjhjz7654321012 |
-- |
-- |
由于开发者令牌从未用于进行 API 调用，因此其 API 访问权限未转移到任何项目。 |
qwertypoiuyu6543298790 |
9876564900 |
测试访问权限 | 由于开发者令牌的 API 访问权限已闲置 90 天，因此已被撤消。项目的 API 访问权限级别默认设置为“测试访问权限”。 |
-- |
7171234567 |
测试访问权限 | 这是一个新项目，尚未与任何开发者令牌搭配使用。 项目的 API 访问权限级别默认设置为“测试访问权限”。 |
我有多个已获批的开发者令牌。您要将 API 访问权限级别转移到哪个项目？
每个获批的开发者令牌的访问权限级别将转移到与该开发者令牌关联的 Google Cloud 项目。查看示例。
我使用多个 Google Cloud 项目。您要将 API 访问权限级别转移到哪个项目？
如果您在过去 90 天内使用已获批的开发者令牌使用了多个 Google Cloud 项目，那么这些项目将获得与您的开发者令牌相同的 API 访问权限级别。查看示例。
我不再使用的项目被分配了 API 访问权限级别。如何解决此问题？
如果 Google Ads API 访问权限分配给了您不再使用的 Google Cloud 项目，则您无需执行任何其他操作。如果项目连续 90 天无活动，Google 将撤消该项目的 API 访问权限。
未向我的 Google Cloud 项目分配 API 访问权限级别。如何解决此问题？
您的 Google Cloud 项目未继承开发者令牌的访问权限，这可能是因为您从未将开发者令牌和云项目用于发出 API 调用，或者您的开发者令牌的 API 访问权限最近因不活动而过期。如需解决此问题，请从 Google Ads API 概览页面为相应项目申请适当的 API 访问权限级别。查看示例。
在哪里可以查看项目的 API 访问权限级别？
您可以在 Google Ads API 概览页面中查看 Google Cloud 项目的 API 访问权限级别。
如何申请更高级别的 API 访问权限？
您可以从 Google Ads API 概览页面为您的 Google Cloud 项目申请更高的 API 访问权限级别。
我的待处理 API 访问权限申请会怎么样？
您在 2026 年 9 月 9 日之前从 Google Ads 经理账号的 API 中心发起的任何待处理的基本访问权限申请都将被关闭。您应从 Google Cloud 项目的 Google Ads API 概览页面重新申请基本版访问权限。如果您受到此变更的影响，将会收到一封包含必要说明的电子邮件。
对于您在 2026 年 9 月 9 日之前通过 Google Ads 经理账号的 API 中心提交的任何待处理的标准访问权限申请，我们将照常进行审核。如果获得批准，与您的开发者令牌关联的 Google Cloud 项目将获得标准访问权限。
我可以将已获批的开发者令牌重新关联到新的 Google Cloud 项目吗？
过去，Google Ads API 团队会根据具体情况支持将开发者令牌与新的 Google Cloud 项目重新关联。自 2026 年 9 月 9 日起，此功能已不再受支持，因为我们已停用开发者令牌。如果您需要使用新的 Google Cloud 项目，则应从 Google Cloud 项目的 Google Ads API 概览页面申请相应的 API 访问权限。
我有一个已获批准的开发者令牌，但从未使用过。我可以使用此开发者令牌吗？
不可以，您无法使用此开发者令牌。有两种可能性：
您的开发者令牌访问权限可能会因不活跃而被撤消：根据 Google 政策，如果您的 API 令牌连续 90 天未使用，Google 可能会撤消相应令牌。如果您有一段时间未使用开发者令牌，则很可能因闲置而导致其访问权限级别被撤消。如果属于这种情况，请从 Google Ads API 概览页面重新申请 Google Cloud 项目的 API 访问权限。查看示例。
您的开发者令牌最近已获批，但您在 2026 年 9 月 9 日之前从未用过该令牌：由于您在 2026 年 9 月 9 日之前从未将已获批的开发者令牌与 Google Cloud 项目搭配使用，因此其访问权限级别未转移到 Cloud 项目。因此，您无法再使用自己的开发者令牌。如果您尝试使用此开发者令牌向正式版账号发出 API 调用，系统会抛出
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION错误。如需修正此错误，请在 Google Cloud 项目的 Google Ads API 概览页面中申请相应的 API 访问权限。查看示例。
在这两种情况下，您都可以申请 Explorer 访问权限和基本访问权限，并自动接受审核；您不再需要与 Google 的合规性团队合作来完成审核流程。如果您需要标准权限，则需要进行人工审核。不过，您可以在申请标准访问权限时分享已获批的开发者令牌详细信息，以便合规性团队相应地审核您的新标准访问权限申请。
我可以停止在 API 请求中发送开发者令牌吗？
可以，您可以停止在 API 请求中发送开发者令牌。如果您使用客户端库，可能需要升级到最新版本。查看库的更改日志，确认它是否支持在不指定开发者令牌的情况下进行 API 调用。
我参与了 Cloud 受管访问权限级别 Beta 版计划。我会受到什么影响？
云端受管访问权限试点计划旨在让 Google Cloud 开发者无需在 API 请求中发送开发者令牌即可进行 API 调用。由于我们已弃用开发者令牌，因此将停止此计划。
您有效开发者令牌的访问权限级别已转移到您的 Google Cloud 项目，因此您现有的代码应该可以继续正常运行，而无需进行任何更改。如果您需要使用新的 Google Cloud 项目，则应从 Google Cloud 项目的 Google Ads API 概览页面申请 API 访问权限。
我的开发者令牌曾列入许可名单。我会受到什么影响？
Google 可能会开展试点计划，让部分开发者能够使用实验性功能。有时，您可以通过将开发者令牌添加到许可名单来获取这些功能的访问权限。如果您参与了此类小规模测试计划，则无需采取任何行动。
我们已更新所有试点计划，以使用 Google Cloud 项目而非开发者令牌作为许可名单机制，并将开发者令牌的许可名单状态转移到关联的 Google Cloud 项目。您现有的代码应能继续正常运行，无需进行任何更改。如果您仍然遇到问题，请与将您纳入 Beta 版计划的 Google 客户经理联系。
我有一个已获批的开发者令牌，想将其用于新的 Google Cloud 项目。可以这样做吗？
不可以，您无法将新的 Google Cloud 项目与已获批的开发者令牌搭配使用。由于您在 2026 年 9 月 9 日之前从未将已获批的开发者令牌与新的 Google Cloud 项目搭配使用，因此其访问权限未转移到该 Cloud 项目。如果您尝试使用此开发者令牌进行 API 调用，系统会抛出 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 错误，因为开发者令牌不再用于确定您的 API 访问权限级别。如需修正此错误，请从 Google Cloud 项目的 Google Ads API 概览页面申请相应的 API 访问权限。查看示例。
我的开发者令牌被泄露给了外部人员。我需要重置开发者令牌吗？
不需要，在这种情况下，您无需重置开发者令牌。由于我们将您的开发者令牌的 API 访问权限级别转移到了您的 Google Cloud 项目，未经授权的用户将无法再使用您的开发者令牌访问自己的 Google Cloud 项目。
API 中心会受到什么影响？
Google Ads 经理账号中的现有 API 中心页面已弃用，将在不久的将来移除。如果您已有开发者令牌，仍然可以登录 Google Ads 经理账号并查看详细信息。不过，这些信息仅供您参考。请勿在此页面上执行与开发者令牌访问权限级别相关的任何任务，例如申请更高级别的 API 访问权限。
如果您需要申请更高的 API 访问权限级别，应通过 Google Cloud 项目的 Google Ads API 概览页面进行申请。
我是否仍需要 Google Ads 经理账号才能使用 Google Ads API？
您不再需要 Google Ads 经理账号即可使用 Google Ads API。只有在需要使用 API 关联和管理多个账号时，您才需要经理账号。
我是新开发者。如何注册 Google Ads API？
按照入门指南中的说明注册 Google Ads API。请勿通过 Google Ads 经理账号的 API 中心申请开发者令牌；这些申请将不会得到处理。API 中心将在不久的将来停用。