获取开发者令牌

开发者令牌是一个长度为 22 个字符的字母数字字符串,可让您的应用连接到 Google Ads API。Google 为您分配令牌后,您可以在 Google Ads 经理账号的 API 中心页面上查看该令牌或创建新的令牌。

每个开发者令牌都会分配一个访问权限级别,该级别用于控制您每天可以使用该令牌进行的 API 调用次数,以及您可以向哪些环境发出调用。

如需针对您的正式版账号发出 API 调用,您必须在申请令牌的过程中为开发者令牌申请基本访问权限标准访问权限。由于不需要这些访问权限级别即可对测试账号进行调用,因此您可以继续进行练习,但我们建议您在完成本指南后,查看如何申请基本访问权限

是否需要新的开发者令牌?

您是否应注册新的开发者令牌取决于几个因素。以下介绍了一些常见的情况:

场景
后续步骤
贵公司之前从未使用过 Google Ads API,并且您希望自行开发应用 注册新的开发者令牌。了解详情
贵公司目前正在使用或过去曾使用过 Google Ads API Google 通常会向每家公司授予一个开发者令牌,因此,如果贵公司已在使用 Google Ads API,则应重复使用现有的开发者令牌。了解详情
贵公司已在使用 Google Ads API,但同时也在开发新产品或工具 如果您确定无法使用现有的开发者令牌,则可以申请新的开发者令牌,并在申请中说明您的用例。 在本指南的其余部分中,您可以使用现有的开发者令牌。了解详情
贵公司使用第三方应用 只有在开发自己的应用时,您才需要开发者令牌。如果您使用第三方应用或服务,则该应用的开发者需要为该应用获取开发者令牌。如果您对自己的情况不清楚,请与 API 合规团队联系

如何申请开发者令牌

申请开发者令牌分为两步。

第 1 步:选择或创建 Google Ads 经理账号

如果您已有 Google Ads 经理账号,请在申请令牌时选择该账号。如果此经理账号尚未与您的其他账号相关联,我们建议您将其置于账号层次结构的根目录下,以简化令牌审核流程并简化日后的账号管理。

如果您没有经理账号,可以按照帮助中心说明创建一个。

第 2 步:申请访问 Google Ads API

请注意,开发者令牌审核流程可能需要一些时间才能完成。 了解详情

  1. 登录您的经理账号。您可以验证该账号是否为经理账号。

  2. 在页面顶部的搜索栏中,输入“API Center”,然后从搜索自动补全功能中选择该字词。API 中心选项仅适用于 Google Ads 经理账号,而不适用于客户账号测试经理账号

  3. 填写 API 访问权限表单,并接受条款及条件。

  • 确保您的信息正确无误,并且贵公司的网站网址有效。如果网站未发布,Google 可能无法处理您的申请并将其拒绝。

  • 请确保您提供的 API 联系电子邮件地址指向的是您经常查收邮件的收件箱。Google 的 API 合规性团队可能会在审核过程中通过此电子邮件地址与您联系,以便您提供澄清信息。如果我们无法联系到您,Google 可能无法继续处理您的申请。

    您可以在 API 中心修改 API 联系电子邮件地址。请及时更新这些信息,即使在申请流程结束后也要如此,以便 Google 向您发送重要的服务通告。

完成申请流程后,开发者令牌会显示在您的 API 中心内,状态为待批准。您的开发者令牌现在具有测试访问权限级别,您可以开始对测试账号发出 API 调用了。

获取开发者令牌后,请记下其值,因为您在进行首次 API 调用时需要用到它。

确认您是否已登录经理账号

您必须登录经理账号才能访问开发者令牌,且该账号不能是测试账号。

如需验证您是否已登录经理账号,请按以下步骤操作:

  1. 登录您的账号。

  2. 选择左侧的管理。如果您在左上角看到经理账号设置,则表示您已登录经理账号。如果您看到账号设置,则表示您已登录客户账号。

  3. 如果右上角以红色显示测试账号,则表示您的账号是测试经理账号或测试广告客户账号。

在哪里可以找到开发者令牌

您可以在 Google Ads 经理账号的 API 中心页面中找到开发者令牌(如果有)。

  1. 登录您的经理账号。您可以验证该账号是否为经理账号。

  2. 在页面顶部的搜索栏中,输入“API Center”,然后从搜索自动补全功能中选择该字词。API 中心选项仅适用于 Google Ads 经理账号,而不适用于测试经理账号

开发者令牌及其访问权限级别是“API 访问权限”下列出的第一个值。