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

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

访问权限级别

下表列出了四种不同的开发者令牌访问权限级别,并按顺序排列。如果您尚未获得 Google Ads API 访问权限,可以先注册以获取测试账号访问权限级别的开发者令牌。您可以在应用中完成一些额外的步骤来提高访问权限级别。

访问权限级别 可以访问... 每日操作次数上限1 如何申请 审核流程通常需要多长时间?
测试账号访问权限级别 测试账号 每天 15,000 次操作 操作说明
Explorer 访问权限级别 测试账号和生产账号 生产账号每天 2,880 次操作
测试账号每天 15,000 次操作
操作说明
基本访问权限级别 测试账号和产品账号 测试账号和生产账号每天最多可执行 15,000 次操作 操作说明 2 个工作日
标准访问权限级别 测试账号和产品账号 测试账号和正式版账号每天的操作次数不受限制 操作说明 10 个工作日

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

测试账号访问权限级别

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

如何申请测试账号访问权限级别

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

Explorer 访问权限级别

在您完成 Google Ads API 的初始注册后,在某些情况下,Google 可能会自动将您的开发者令牌从测试账号访问权限级别升级为探索者访问权限级别。探索者访问权限级别允许开发者令牌针对测试账号和生产账号发出 Google Ads API 请求。正式版账号是指投放真实有效的 Google 广告的任何账号,而测试账号不会投放广告。

探索者访问权限级别允许开发者令牌每天针对正式版账号执行最多 2,880 次操作。这足以让大多数开发者开始使用该 API 并构建基本自动化功能。

探索者访问权限级别会限制对以下功能的访问。如果您需要使用这些功能,则需要申请基本访问权限级别标准访问权限级别

功能受限 受限的服务和方法
创建账号 CustomerService.CreateCustomerClient
用户管理 CustomerUserAccessInvitationService
CustomerUserAccessService
规划 KeywordPlanService
KeywordPlanIdeaService
KeywordPlanCampaignService
KeywordPlanCampaignKeywordService
KeywordPlanAdGroupService
KeywordPlanAdGroupKeywordService
AudienceInsightsService
KeywordPlanIdeaService
ReachPlanService
账号结算和付款 PaymentsAccountService
BillingSetupService
AccountBudgetProposalService
InvoiceService

如何申请探索者访问权限级别

在 Google Ads 网页界面中完成 Google Ads API 注册。在某些情况下,您完成注册后,Google 可能会自动将您的开发者令牌升级到 Explorer 访问权限级别。

基本访问权限级别

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

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

如何申请基本访问权限级别

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

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

标准访问权限级别

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

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

如何申请标准访问权限级别

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

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

API 配额和系统速率限制

无论访问权限级别如何,所有 API 操作都受系统速率限制的约束,该限制会限制您在一段时间内(即每小时)可执行的操作数量。如需详细了解如何处理速率限制错误,请参阅错误类型

由于产品设计限制、产品政策限制、API 性能和延迟时间考虑因素等原因,个别服务可能会强制执行额外的限制和配额限制。如需详细了解这些限制,请参阅有关 API 配额的文档。

允许的用途

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

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

如何更改允许的使用情形

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