开发者令牌是一个长度为 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
请注意,开发者令牌审核流程可能需要一些时间才能完成。 了解详情。
登录您的经理帐号,然后点击搜索按钮。
输入“API 中心”,然后从搜索自动补全中选择它。API 中心选项仅针对 Google Ads 经理帐号显示,不会对广告客户帐号或测试经理帐号显示。
填写“API 访问权限”表单并接受条款及条件。
请确保您的信息正确无误,并且贵公司的网站网址正常运行。如果网站尚未上线,Google 可能无法处理您的申请并拒绝您的申请。
确保您提供的 API 联系电子邮件地址指向定期查阅的收件箱。在审核过程中,Google 的 API 合规性团队可能会与此电子邮件地址联系以澄清说明。如果无法联系到您,Google 可能无法继续处理您的申请。
您可以在 API 中心修改 API 联系电子邮件地址。即使在申请流程结束后,也请及时更新这些信息,以便 Google 可以向您发送重要的服务通告。
完成申请流程后,开发者令牌会在您的 API 中心显示为待审批状态。您的开发者令牌现在已拥有测试访问权限级别,您可以开始对测试帐号进行 API 调用。
获取开发者令牌后,请记录其值,因为您在进行首次 API 调用时需要用到该令牌。
在哪里可以找到您的开发者令牌
您可以在 Google Ads 经理帐号的 API 中心页面上找到现有的开发者令牌。
登录您的经理帐号,然后点击搜索按钮。
输入“API 中心”,然后从搜索自动补全中选择它。API 中心选项仅针对 Google Ads 经理帐号显示,不会对测试经理帐号显示。
开发者令牌及其访问权限级别是 API 访问权限下的首要值。