您的 Google Cloud 项目会被分配一个访问权限级别和“允许的用途”。访问权限级别 决定了您能否对生产账号产生影响,以及每天可以执行的操作次数和请求次数。允许的用途 决定了项目可以使用的特定 Google Ads API 功能。
访问权限级别
下表列出了四种不同的 API 访问权限级别,并按顺序排列。如果您尚未获得 Google Ads API 访问权限,可以先 启用该 API,以便为您的 Google Cloud 项目获取测试访问 权限级别。您可以在应用中完成一些额外的步骤,以提高访问权限级别。
| 访问权限级别 | 可以访问… | 每日操作次数上限 1 | 如何申请 | 审核通常需要多长时间? |
|---|---|---|---|---|
| 测试 | 测试账号 | 每天 15,000 次操作 | 申请测试访问权限 | |
| 探索器 | 测试账号和生产账号 | 生产账号每天 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 可能会允许您申请探索器访问权限级别。
探索器访问权限级别允许您的 Google Cloud 项目针对测试账号和生产账号发出 Google Ads API 请求。生产账号 是指投放真实 Google 广告的任何账号,而测试账号不会投放广告。
探索器访问权限级别允许您的 Google Cloud 云项目每天针对生产账号执行最多 2,880 次操作。对于大多数开发者来说,这足以开始使用该 API 并构建基本的自动化功能。
探索器访问权限级别会限制对以下功能的访问。如果您 需要使用这些功能,则需要申请 基本访问权限级别或标准访问权限级别。
申请探索器访问权限级别
- 在您的 Google Cloud 项目中,前往 Google Ads API 概览页面。
- 验证该页面是否将您当前的访问权限级别显示为测试 。
- 点击展开升级访问权限级别 部分。
- 确认下一个访问权限级别 显示为探索器 。
- 点击申请访问权限 按钮,申请探索器访问权限级别。
提交申请后,Google 可能会自动将项目的 API 访问权限级别升级为探索器。
基本访问权限级别
基本访问权限级别允许您的 Google Cloud 项目针对测试账号和生产账号发出 Google Ads API 请求。生产账号 是指投放真实 Google 广告的任何账号,而测试账号不会投放广告。
基本访问权限级别允许您的 Google Cloud 项目每天执行最多 15,000 次操作。对于大多数开发者来说,这已经足够。
申请基本访问权限级别
- 在您的 Google Cloud 项目中,前往 Google Ads API 概览页面。
- 验证该页面是否将您当前的访问权限级别显示为探索器 。
- 点击展开升级访问权限级别 部分。
- 确认下一个访问权限级别 显示为基本 。
- 确认没有警告表明您尚未为项目完成品牌验证。如果有, 请按照说明完成品牌验证 ,然后再继续。
- 点击申请访问权限 按钮,申请基本访问权限级别。
提交申请后,Google 可能会自动将项目的 API 访问权限级别升级为基本 。
标准访问权限级别
标准访问权限级别允许您的 Google Cloud 项目每天针对所有服务执行的操作次数不限。各个服务和功能 可能仍有速率限制和限制,这些限制特定于 这些功能,即使您的项目具有标准 访问权限级别,这些限制仍将适用。
标准访问权限级别仅授予需要无限次 Google Ads API 操作的开发者,例如大型公司或为许多用户提供服务的工具。
申请标准访问权限级别
- 在您的 Google Cloud 项目中,前往 Google Ads API 概览页面。
- 验证该页面是否将您当前的访问权限级别显示为基本 。
- 点击展开升级访问权限级别 部分。
- 确认下一个访问权限级别 显示为标准 。
- 点击开始申请 按钮,开始申请标准访问权限级别。
标准权限申请需要对您的应用进行详细的人工审核。请准备好回答有关工具的功能及其目标受众的问题。如果您的工具供外部用户使用,请准备好提供工具的演示登录访问权限。请注意,您的工具必须符合 最低功能要求。
在整个审核过程中,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 项目已获批准使用标准访问权限级别,您 可以填写申请来更新允许的用途。如果您想更新允许的用途或授予客户对您的工具的访问权限,请填写申请。