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

每个 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 访问权限级别。探索者访问权限级别允许开发者令牌针对测试账号和生产账号发出 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. 在网络浏览器中前往 https://ads.google.com/aw/apicenter。如果系统提示，请登录您的 Google Ads 经理账号。

    访问 API 中心

  2. 验证您的访问权限级别是否为测试账号或探索者。

  3. 确保 API 中心内的 API 联系电子邮件地址是最新的。您必须提供有效且经常查看的电子邮件地址，才能完成申请流程。确保您已将所有有效的 Google Ads 账号与具有 API 令牌的 Google Ads 经理账号相关联。

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

完成 Google Cloud 项目的品牌验证

Google Ads API 在审核基本访问权限级别的申请时，会使用与开发者令牌关联的 Google Cloud 项目的品牌验证状态。您可以在 Google Cloud 项目中完成品牌验证流程，以加快基本访问权限申请的审核流程。在某些情况下，Google 还可能会要求您在 Google Cloud 项目中完成品牌验证，作为处理您的基本访问权限申请的前提条件。如需了解详情，请参阅品牌验证指南。

标准访问权限级别

标准访问权限级别允许开发者令牌每天针对大多数服务执行无限次操作。这包括但不限于 GoogleAdsService Search 和 SearchStream。如需详细了解标准访问权限级别的限制和例外情况，请参阅 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.Search 或 GoogleAdsService.SearchStream 请求，或只读调用。此方法适用于仅使用 API 请求统计信息的开发者。
研究关键字和建议 允许开发者令牌访问 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。 此字段仅供需要建议的工具使用，以帮助用户更轻松地制作和管理 Google Ads 广告系列。

如何更改允许的使用情形

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

上一页
开发者令牌
下一页
品牌验证