访问权限级别和允许的用途

每个 Google Ads API 开发者令牌都分配了访问权限级别和“允许的用途”。访问权限级别决定了您是否可以影响生产账号，以及每天可以执行的操作和请求数量。 允许的用途决定了开发者令牌可以使用的特定 Google Ads API 功能。

访问权限级别

下表中按顺序列出了三种不同的访问权限级别。如果您还没有 Google Ads API 访问权限，可以先注册以获取测试账号访问权限。您可以在应用中完成一些额外的步骤来提高访问权限级别。

访问权限级别	可以访问...	每日操作次数上限¹	应用
测试账号访问权限	测试账号	每天 15,000 次操作	操作说明
基本访问权限	测试账号和生产账号	每天 15,000 次操作	操作说明
标准权限	测试账号和生产账号	每天的操作次数不限	操作说明

¹“每天”是指使用您的开发者令牌发出 API 请求的 24 小时滑动时间段。如果您的应用在过去 24 小时内超出您访问权限级别的请求限额，则会收到错误。

您完成 Google Ads API 的初始注册后，系统会向您发放一个具有“测试账号访问权限”级别的开发者令牌。这意味着该开发者令牌只能针对测试账号发出 Google Ads API 请求。

在 Google Ads 界面中完成 Google Ads API 注册，即可自动获得“测试账号”访问权限级别。

基本访问权限级别允许开发者令牌针对测试账号和生产账号发出 Google Ads API 请求。正式版账号是指投放真实的 Google 广告的任何账号，而测试账号不投放广告。

基本访问权限级别允许开发者令牌每天执行最多 15,000 次操作。这对于大多数开发者来说已经足够。

如果您拥有测试账号访问权限级别的开发者令牌，并且想要申请正式账号访问权限，请填写基本访问权限申请表单。确保您已完成以下步骤：

确保您已拥有具有“测试账号访问权限”级别的开发者令牌。
确保 API 中心内的 API 联系电子邮件地址是最新的。您必须登录经理账号才能看到 API 中心。如果没有有效的且经常查看的电子邮件地址，您将无法完成申请流程。确保您已将所有有效的 Google Ads 账号与具有 API 令牌的经理账号相关联。

标准访问权限级别允许开发者令牌每天针对大多数服务执行无限次操作。这包括但不限于 GoogleAdsService Search 和 SearchStream。如需详细了解标准访问权限级别的限制和例外情况，请参阅 API 配额。

标准访问权限级别仅授予需要无限 Google Ads API 操作的开发者，例如大型公司或为许多用户提供服务的工具。

无论访问权限级别如何，所有 API 操作都受系统速率限制的约束。如需详细了解如何处理速率限制错误，请参阅错误类型。

如果您拥有基本访问权限级别的开发者令牌，并且想要申请不受限的 Google Ads API 操作，请填写标准访问权限申请表单。

如果您的工具是外部工具，请准备好提供该工具的演示登录访问权限。请注意，您的工具必须符合最低功能要求。

允许的用途仅适用于具有基本访问权限和标准访问权限级别的开发者令牌。允许的使用量是根据 Google Ads API 的预期用途分配的。这些权限决定了开发者令牌可用于 API 的哪些功能，如下表所示：

允许的使用情形	说明
广告制作 / 管理	提供对 API 所有服务的访问权限，以便创建和管理 Google Ads 广告系列、广告组、广告和关键字。
报告	仅发出 `GoogleAdsService.Search` 或 `GoogleAdsService.SearchStream` 请求，或只读调用。此权限适用于仅使用该 API 请求统计信息的开发者。
研究关键字和建议	允许令牌访问 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。此属性仅供需要建议的工具使用，以帮助用户更轻松地制作和管理 Google Ads 广告系列。

如果您的开发者令牌已获批基本权限或标准权限，您可以填写申请来更新允许的用途。如果您想更新许可的使用范围或向客户授予对您的工具的访问权限，请填写申请表单。