开发者令牌是一个包含 22 个字符的字母数字字符串,可让您的应用连接到 Google Ads API。您可以在 Google Ads 经理账号的 API 中心页面上注册获取一个。每当您进行 API 调用时,都需要通过设置 developer-token HTTP 或 gRPC 标头,将开发者令牌作为请求的一部分发送。
每个开发者令牌都会分配一个访问权限级别,该级别会控制您每天可以使用该令牌进行的 API 调用次数,以及可以进行调用的环境。
申请开发者令牌时,您可能默认获得探索者访问权限级别。这样,您就可以针对生产账号进行调用,但会受到某些限制。在某些情况下,如果我们无法自动审核您的开发者令牌申请,可能会改为向您的开发者令牌授予测试账号访问权限级别。这样,您只能针对测试账号进行 API 调用。如需移除探索者账号和测试账号访问权限级别的限制,您必须为自己的开发者令牌申请基本访问权限级别或标准访问权限级别。您的开发者令牌申请经过审核并获得批准后,您的开发者令牌将获得相应的访问权限级别。
您是否需要新的开发者令牌?
您是否应申请新的开发者令牌取决于多种因素。以下介绍了一些常见的情况:
场景 |
后续步骤 |
| 您的公司之前从未用过 Google Ads API,并且您想开发自己的应用 | 申请新的开发者令牌。了解详情 |
| 贵公司目前正在使用或过去曾使用过 Google Ads API | Google 通常会为每家公司授予一个开发者令牌,因此如果您的公司已在使用 Google Ads API,则应重复使用现有的开发者令牌。了解详情 |
| 您的公司已在使用 Google Ads API,但同时也在开发新产品或工具 | 如果您确定无法使用现有的开发者令牌,则可以申请新令牌,并在申请中说明您的使用情形。 在本指南的其余部分,您可以使用现有的开发者令牌。了解详情 |
| 贵公司使用第三方应用 | 只有在开发自己的应用时,您才需要开发者令牌。如果您使用的是第三方应用或服务,则该应用的开发者需要为该应用获取开发者令牌。如果您不确定自己的情况,请与 API 合规性团队联系。 |
哪些人可以申请开发者令牌?
公司和个人开发者都可以申请开发者令牌。下表总结了在注册开发者令牌时需要提供的详细信息。
| 如果您是 | 然后提供以下开发者详细信息 | 其他说明 |
|---|---|---|
| 代表贵公司或产品团队的开发者 | 贵公司的名称和网址 | Google 通常会为每家公司授予一个开发者令牌,但也会根据具体情况批准为不同的工具授予不同的开发者令牌。 |
| 不代表任何公司的个人开发者 | 将您的公司名称指定为 Individual。您可以提供备选网址,例如您的 GitHub 个人资料网址或 LinkedIn 个人资料网址,而不是公司网址。 |
您需要以某种形式在线展示,并且必须向 Google 提供一个网址,以便我们评估您打算如何使用 Google Ads API。我们不受理 test.com 和 example.com 等通用网址。 |
如何申请开发者令牌
申请开发者令牌时需要执行两个步骤。
第 1 步:选择或创建 Google Ads 经理账号
如果您已有 Google Ads 经理账号,请在申请开发者令牌时选择该账号。如果此经理账号尚未与您的其他账号相关联,建议您将其置于账号层次结构的根级,以便简化令牌审核流程,并方便日后管理账号。
如果您没有经理账号,可以按照帮助中心说明创建一个。
第 2 步:申请访问 Google Ads API
请注意,开发者令牌审核流程可能需要一些时间才能完成。了解详情。
在网络浏览器中前往 https://ads.google.com/aw/apicenter。如果系统提示,请登录您的 Google Ads 经理账号。
填写 API 访问权限表单并接受条款及条件。
确保您的信息正确无误,并且公司网站网址有效。如果网站未上线,Google 可能无法处理您的申请并会拒绝该申请。
确保您提供的 API 联系人电子邮件地址指向的是经常有人监控的收件箱。在审核过程中,Google 的 API 合规性团队可能会通过此电子邮件地址与您联系,以寻求澄清。如果您无法接听电话,Google 可能不会继续处理您的申请。
您可以在 API 中心内修改 API 联系电子邮件地址。即使在申请流程结束后,也请务必及时更新此信息,以便 Google 向您发送重要的服务通知。
完成申请流程后,您的 API 中心会显示开发者令牌,并显示以下结果之一:
- 您的开发者令牌具有探索者访问权限级别,状态为已获批。这意味着,Google 能够自动审核并批准您提交的开发者令牌申请(探索者访问权限级别)。您可以开始针对正式账号或测试账号进行 API 调用。
- 您的开发者令牌具有“测试账号访问权限”级别,状态为“待审批”。这意味着,Google 无法自动审核并批准您申请的探索者访问权限级别的开发者令牌。您可以开始针对测试账号进行 API 调用。完成本指南后,我们建议您了解如何申请基本访问权限级别
验证您是否已登录 Google Ads 经理账号
您必须登录 Google Ads 经理账号才能访问开发者令牌, 且该账号不能是 Google Ads 测试经理账号。
如需验证您是否已登录 Google Ads 经理账号,请按以下步骤操作:
在网络浏览器中前往 https://ads.google.com/aw/apicenter。
如果您登录的是客户账号,该页面将显示API 中心仅适用于经理账号。
如果右上角以红色显示测试账号,则表示您的账号是测试经理账号或测试广告客户账号。
在哪里可以找到开发者令牌
您可以在 Google Ads 经理账号的 API 中心页面中找到开发者令牌(如果有)。