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

每个 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 广告系列的工具才会使用此权限。

如果您已获批基本访问权限或标准访问权限级别，则可以填写申请更新允许的使用情形。如果您想更新允许的使用情形或向客户授予对您工具的访问权限，请填写申请表单。