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

每个 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 可能会 自动将您的开发者令牌从 测试账号访问权限 级别升级到 Explorer 访问权限级别。 Explorer 访问权限级别允许开发者令牌针对测试账号和生产账号发出 Google Ads API 请求。生产账号 是指投放真实 Google 广告的任何账号,而测试账号不会投放广告。

Explorer 访问权限级别允许开发者令牌针对生产账号每天执行最多 2,880 次操作。对于大多数开发者来说,这足以开始使用 API 并构建基本的自动化功能。

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

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

如何申请 Explorer 访问权限级别

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

基本访问权限级别

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

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

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

如果您拥有具有测试账号访问权限级别或 Explorer 访问权限级别的开发者令牌,则可以按如下方式申请基本访问权限级别:

  1. 在网络浏览器中前往 https://ads.google.com/aw/apicenter 。系统可能会提示您登录 Google Ads 经理账号。

    访问 API 中心

  2. 验证您的访问权限级别测试账号 还是 Explorer

  3. 确保 API 中心内的 API 联系电子邮件地址 是最新地址。如果没有有效且定期查看的电子邮件地址,您将无法完成申请流程。确保您已将所有有效的 Google Ads 账号与具有 API 令牌的 Google Ads 经理账号相关联。

  4. 点击访问权限级别 旁边的下拉箭头,然后点击申请基本访问权限 链接。

标准访问权限级别

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

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

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

如果您拥有具有基本访问权限级别的开发者令牌,则可以按如下方式申请标准访问权限级别:

  1. 在网络浏览器中前往 https://ads.google.com/aw/apicenter 。系统可能会提示您登录 Google Ads 经理账号。

    访问 API 中心

  2. 验证您的访问权限级别基本

  3. 确保 API 中心内的 API 联系电子邮件地址 是最新地址。如果没有有效且定期查看的电子邮件地址,您将无法完成申请流程。确保您已将所有有效的 Google Ads 账号与具有 API 令牌的 Google Ads 经理账号相关联。

  4. 点击访问权限级别 旁边的下拉箭头,然后点击申请标准访问权限 链接。

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

API 配额和系统速率限制

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

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

允许的用途

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

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

如何更改允许的用途

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