开发者令牌 是一个由 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 经理账号。请勿通过 API 中心页面注册开发者令牌，也不要尝试通过 Google Ads 经理 账号中的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 Ads API 概览页面 Google Cloud 项目，然后申请 Explorer 访问权限。
基本访问权限和标准访问权限需要进行品牌验证
对于新的基本访问权限和标准访问权限申请，您必须完成 品牌 验证 的 Google Cloud 项目。现有访问权限持有者无需完成品牌验证，但我们建议您完成验证。
基本访问权限申请现在是自动化的，将在品牌验证和提交后几分钟内得到审核。
由于这些流程更新，所有待处理的基本 API 访问权限申请都将在此次过渡期间关闭。受影响的申请者将收到一封电子邮件 ，其中包含详细信息，他们应通过Google Ads API 概览 页面重新申请 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具有标准访问权限。它曾与项目 ID1234567890、5678912345、45678912345一起使用。 - 开发者令牌 2：
xyzabcdefghi6789012345具有基本访问权限。它曾与项目 ID1231235678一起使用。 - 开发者令牌 3：
asdfgflkjhjz7654321012具有基本访问权限，但从未用于进行 API 调用。它最近已获批准。 - 开发者令牌 4：
qwertypoiuyu6543298790曾具有标准访问权限，但在过去 90 天内未使用过。项目 ID9876564900过去曾与此开发者令牌一起使用。 - 云项目：云项目 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 项目，则您无需采取任何其他操作。Google 将在 90 天无活动后撤消未使用项目的 API 访问权限。
API 访问权限级别未分配给我的 Google Cloud 项目。如何解决此问题？
您的 Google Cloud 项目未继承开发者令牌的访问权限级别，可能是因为您从未将开发者令牌和 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 代管访问权限级别试用计划。我会受到什么影响？
Cloud 代管访问权限级别试用 计划旨在让 Google Cloud 开发者无需在 API 请求中发送开发者令牌即可进行 API 调用。现在我们已停用开发者令牌，此计划也将停止。
您活跃的开发者令牌的访问权限级别已转移到您的 Google Cloud 项目，因此您的现有代码应能继续正常运行，无需进行任何更改。如果您需要使用新的 Google Cloud 项目，则应通过 Google Cloud 项目的 Google Ads API 概览页面申请 API 访问权限 。
我的开发者令牌位于许可名单中。我会受到什么影响？
Google 可能会运行试用计划，让部分开发者能够使用实验性功能。有时，您可以通过将开发者令牌添加到许可名单来使用这些功能。如果您参与了此类试用计划，则无需采取任何行动。
我们已更新所有试用计划，改用 Google Cloud 项目（而不是开发者令牌）作为许可名单机制，并将开发者令牌的许可名单状态转移到关联的 Google Cloud 项目。您的现有代码应能继续正常运行，无需进行任何更改。如果您仍然遇到问题，请与将您纳入试用计划的 Google 客户经理联系。
我有一个已获批准的开发者令牌，并且想将其与新的 Google Cloud 项目一起使用。可以这样做吗？
不可以，您无法将新的 Google Cloud 项目与已获批准的开发者令牌一起使用。由于您在 2026 年 9 月 9 日之前从未将已获批准的开发者令牌与新的 Google Cloud 项目一起使用，因此其访问权限级别未转移到 Cloud 项目。如果您尝试使用此开发者令牌进行 API 调用，我们将抛出
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 错误，因为开发者令牌不再用于确定您的 API 访问权限级别。如需解决此错误，请通过 Google Cloud 项目的
适当 API 访问权限申请Google Ads API 概览
页面。请参阅示例。
我的开发者令牌在外部泄露了。我需要重置开发者令牌吗？
不需要，在这种情况下，您无需重置开发者令牌。由于我们将开发者令牌的 API 访问权限级别转移到了您的 Google Cloud 项目，未经授权的用户无法再使用自己的 Google Cloud 项目来使用您的开发者令牌。不过，如果您愿意，可以随时通过 API 中心重置开发者令牌。
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 中心将在不久的将来停用。