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

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

访问权限级别

下表按顺序列出了四种不同的 API 访问权限级别。如果您尚未获得 Google Ads API 访问权限，可以先启用该 API，以便为您的 Google Cloud 项目获取测试账号访问权限。您可以在应用中完成一些额外的步骤，以提高访问权限级别。

访问权限级别 可以访问… 每日操作次数上限 1 如何申请 审核流程通常需要多长时间？
测试账号访问权限级别 测试账号 每天 15,000 次操作 申请测试账号访问权限
Explorer 访问权限级别 测试账号和产品账号 生产账号：每天 2,880 次操作
测试账号：每天 15,000 次操作		 申请使用探索器
基本访问权限级别 测试账号和产品账号 测试账号和生产账号每天 15,000 次操作 申请基本访问权限
标准访问权限级别 测试账号和产品账号 测试账号和生产账号每天的操作次数不受限制 申请标准访问权限 10 个工作日

1“每天”是指在滑动 24 小时的时间段内，使用您的 Google Cloud 项目发出的 API 请求。如果您的应用在过去 24 小时内超出您访问权限级别的请求限制，则会收到错误。

测试账号访问权限级别

启用 Google Ads API 后，您的 Google Cloud 项目将获得“测试账号”访问权限级别。这意味着，该项目只能针对测试账号发出 Google Ads API 请求。

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

在您的 Google Cloud 项目中启用 Google Ads API，系统会自动为您的项目授予“测试账号访问权限”级别。

探索者访问权限级别

在您完成 Google Ads API 的初始注册后，Google 可能会允许您申请 Explorer 访问权限级别。

探索者访问权限级别允许您的 Google Cloud 项目针对测试账号和生产账号发出 Google Ads API 请求。正式版账号是指投放真实有效的 Google 广告的任何账号，而测试账号不会投放广告。

探索者访问权限级别允许您的 Google Cloud 项目每天针对生产账号执行最多 2,880 次操作。对于大多数开发者来说，这足以让他们开始使用该 API 并构建基本自动化功能。

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

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

申请探索者访问权限级别

  1. 在您的 Google Cloud 项目中，前往 Google Ads API 概览页面。
  2. 验证该页面是否将您当前的访问权限级别显示为测试。
  3. 点击展开升级访问权限级别部分。
  4. 确认下一个访问权限级别显示为探索者。
  5. 点击申请访问权限按钮，申请探索者访问权限级别。

您提交申请后，Google 可能会自动将您项目的 API 访问权限级别升级为探索者访问权限级别。

基本访问权限级别

基本访问权限级别允许您的 Google Cloud 项目针对测试账号和正式版账号发出 Google Ads API 请求。正式版账号是指投放真实有效的 Google 广告的任何账号，而测试账号不会投放广告。

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

申请基本访问权限级别

  1. 在您的 Google Cloud 项目中，前往 Google Ads API 概览页面。
  2. 验证该页面是否显示您当前的访问权限级别为探索者。
  3. 点击展开升级访问权限级别部分。
  4. 确认下一个访问权限级别显示为基本。
  5. 确认没有警告表明您尚未完成项目的品牌验证。如果有，请按照说明完成品牌验证，然后再继续。
  6. 点击申请访问权限按钮，申请基本访问权限级别。

提交申请后，Google 可能会自动将项目的 API 访问级别升级为基本访问级别。

标准权限级别

标准访问权限级别允许您的 Google Cloud 云项目每天对所有服务执行无限次操作。各个服务和功能可能仍有特定于这些功能的速率限制和限制，即使您的项目具有标准访问权限级别，这些限制也会继续适用。

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

申请标准权限

  1. 在您的 Google Cloud 项目中，前往 Google Ads API 概览页面。
  2. 验证该页面是否将您当前的访问权限级别显示为基本。
  3. 点击展开升级访问权限级别部分。
  4. 确认下一个访问权限级别显示为标准。
  5. 点击开始申请按钮，开始申请标准权限。

标准访问权限申请需要对您的应用进行详细的人工审核。准备好回答有关工具功能及其目标受众群体的问题。如果您的工具供外部用户使用，请准备好提供工具的演示版登录权限。请注意，您的工具必须符合最低功能要求。

在整个审核过程中，Google 合规团队会使用您的电子邮件地址与您沟通。请务必及时回复合规性团队的查询，以便顺利完成标准访问权限申请。审核完成后，Google 会通过电子邮件告知您审核流程的最终结果。

API 配额和系统速率限制

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

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

允许的用途

允许的用途仅适用于具有标准访问权限级别的 Google Cloud 项目。许可用途是根据 Google Ads API 的预期用途分配的。这些权限决定了您的工具可以使用 API 的哪些功能，如下表所示：

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

更改允许的使用

如果您的 Google Cloud 项目已获批使用标准访问权限级别，您可以填写申请以更新允许的用途。如果您想更新许可的使用范围或授予客户对您的工具的访问权限，请填写申请表单。

上一页
开发人员令牌
下一页
品牌验证