每个 Google Ads API 开发者令牌都分配了访问权限级别和“允许的用途”。访问权限级别决定了您是否可以影响生产帐号以及每天可以执行的操作和请求数。允许的用途决定了开发者令牌可以使用的特定 Google Ads API 功能。
访问权限级别
下表中按顺序列出了三种不同的访问权限级别。如果您还没有 Google Ads API 访问权限,则可以先注册,以获得测试帐号访问权限。您可以通过完成应用中一些额外的步骤来提高访问权限级别。
访问权限级别 | 可以访问... | 每日操作限制1 | 应用 |
---|---|---|---|
测试帐号访问权限 | 测试帐号 | 15,000 次操作 / 天 | 说明 |
基本访问权限 | 测试帐号和生产帐号 | 15,000 次操作 / 天 | 说明 |
标准权限 | 测试帐号和生产帐号 | 每天无限次操作 | 说明 |
1“每天”基于使用您的开发者令牌发出 API 请求的浮动时间段(24 小时)。如果您的应用在过去 24 小时内超出了访问权限级别的请求限制,则会收到错误。
测试账号访问权限
完成 Google Ads API 的初始注册后,您会获得一个具有测试帐号访问权限级别的开发者令牌。这意味着该开发者令牌只能针对测试账号发出 Google Ads API 请求。
申请测试账号访问权限
在 Google Ads 网页界面上完成 Google Ads API 注册,以便自动获得测试帐号访问权限级别。
基本访问权限
基本访问权限允许开发者令牌针对测试账号和产品账号发出 Google Ads API 请求。产品帐号是指投放真实的实时 Google 广告的所有帐号,测试帐号不会投放广告。
基本访问权限级别允许开发者令牌每天最多执行 15,000 次操作。这对大多数开发者来说已经足够了。
申请基本访问权限
如果您目前拥有测试帐号访问权限级别的开发者令牌,并且想要申请生产帐号访问权限,请填写基本访问权限申请表单。确保您已完成以下步骤:
- 确保您已拥有具有测试帐号访问权限级别的开发者令牌。
- 确保 API 中心的 API 联系人电子邮件地址是您的最新地址。如果没有定期检查的有效电子邮件地址,您将无法完成申请流程。确保您已将所有有效 Google Ads 帐号与设有 API 令牌的经理帐号相关联。
标准权限
标准访问权限允许开发者令牌每天针对大多数服务执行无限次的操作。这包括但不限于 GoogleAdsService
Search
和 SearchStream
。如需详细了解标准权限的限制和例外情况,请参阅 API 配额。
标准访问权限级别仅授予给需要无限次 Google Ads API 操作的开发者,例如为众多用户提供服务的大型公司或工具。
无论访问权限级别如何,所有 API 操作都受系统速率限制。如需详细了解如何处理速率限制错误,请参阅错误类型。
申请标准访问权限
如果您目前已拥有基本访问权限级别,但想申请无限次的 Google Ads API 操作,请填写标准访问权限申请表单。
如果您的工具是外部工具,请准备好提供该工具的演示登录权限。请注意,您的工具必须符合最低功能要求。
允许的用途
允许的用途仅适用于基本访问令牌和标准访问令牌。允许的用途根据 Google Ads API 的预期用途进行分配。这些权限决定了令牌可用于 API 的哪些功能,如下表所示:
允许的用途 | 说明 |
---|---|
广告制作 / 管理 | 提供所有 API 服务的访问权限,用于制作和管理 Google Ads 广告系列、广告组、广告和关键字。 |
报告 | 只能发出 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 请求,或者只读调用。这适用于仅使用 API 请求统计信息的开发者。
|
研究关键字和建议 | 允许令牌访问 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。仅供那些需要建议来协助制作和管理 Google Ads 广告系列的工具使用。 |
更改允许的用途
如果您已获准使用基本访问权限级别或标准访问权限级别,则可以填写更新允许用途的申请。如果您要更新允许的用途或要向客户授予工具访问权限,请填写申请表单。