每个 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 广告系列的制作和管理的工具使用。 |
更改允许的用途
如果您已获准使用基本访问权限级别或标准访问权限级别,则可以填写更新允许用途的申请。如果您想更新允许的用途或授权客户访问您的工具,请填写申请表。