Google 的开发者令牌可让您的应用连接到 Google Ads API。每个开发者令牌都分配有一个访问权限级别,用于控制每天使用该令牌可发出的 API 调用次数,以及可以进行调用的环境。了解详情。
每个 Google API 控制台项目只能与一个经理帐号的开发者令牌相关联。在您发出 Google Ads API 请求后,开发者令牌将永久与相应 Google API 控制台项目配对。
如果切换到新经理帐号下的开发者令牌,您首先需要为使用该新经理帐号的 Google Ads API 请求创建新的 Google API 控制台项目。如果您不使用新的 Google API 控制台项目,则会在发出请求时收到 DEVELOPER_TOKEN_PROHIBITED
错误。
过程
第 1 步:选择或创建 Google Ads 经理帐号
您必须先拥有 Google Ads 经理帐号才能申请开发者令牌。
创建经理帐号时,不能使用与现有 Google Ads 帐号相同的电子邮件地址。因此,您必须使用尚未与 Google Ads 帐号相关联的电子邮件地址,才能创建经理帐号。
请注意,您选择的经理帐号不会影响您的开发者令牌可以访问的那组 Google Ads 帐号。它只用于存储开发者令牌。
只要您拥有正确的 OAuth 凭据,令牌本身就可以访问任何帐号。不过,您可以将此经理帐号与您公司的有效 Google Ads 帐号相关联,这样就可以在申请 API 时简化应用审核流程,并减少您需要进行的身份验证次数。如需了解详情,请参阅关于关联帐号的帮助中心文章。
第 2 步:申请访问 Google Ads API
通过您的经理帐号注册 Google Ads API 访问权限。登录,然后依次转到工具与设置 > 设置 > API 中心。API 中心选项仅适用于 Google Ads 经理帐号。
您必须填写 API 访问权限表单中的所有字段,并接受条款及条件。请确保您的信息正确无误,且贵公司的网站网址能够正常使用。如果网站不是实际网页,我们将无法处理您的申请。
请确保您提供的 API 联系电子邮件地址指向一个定期监控的收件箱。如果我们无法通过该电子邮件地址与您联系,便无法处理您的申请,并会拒绝您的申请。
您可以在 API 中心修改 API 联系电子邮件地址。
我们强烈建议您在申请流程后及时更新此信息,以便我们向您发送重要的服务公告。
第 3 步:继续申请流程
您的待审批开发者令牌必须先获得批准,然后才能与正式版 Google Ads 帐号配合使用。您可以申请基本访问权限或标准访问权限。
请参阅价目表,确定您需要基本访问权限还是标准访问权限。如果您不确定将来的 API 使用情况,我们建议您从基本访问权限开始,待应用的 API 用量经常达到基本访问权限所规定的配额限制后,再升级到标准访问权限。
我们会对基本访问权限和标准权限应用进行审核,以确保您提议用于 Google Ads API 的工具或软件应用符合我们的条款及条件和政策,包括最低功能要求 (RMF)(如果适用)。如果贵公司为客户管理 Google Ads 帐号,则必须遵守我们的第三方政策,以获取 Google Ads API 的访问权限。
我们通常会在您提交申请后的两个工作日内使用您在第 2 步中提供的电子邮件地址与您联系。如果您无法再访问该收件箱,或者您不打算主动监控此电子邮件地址,请按照上面第 2 步中的说明在 API 中心修改您的电子邮件地址,以便我们能够联系到您。
令牌审核团队批准了我的开发者令牌
当您的 API 访问权限申请获得批准后,分配给生产环境的令牌将在生产环境中激活。您可以通过 API 中心找到您的令牌,可通过您用来申请访问权限的经理帐号的帐号设置菜单进行访问。要访问 API,您需要在与系统进行交互时将令牌添加到请求标头中。
请务必将您的联系电子邮件地址保持最新,因为我们会将有关更改或服务中断的重要信息发送到您指定的电子邮件地址。
如果您以后对工具做出任何更改,则必须填写 Google Ads API 工具更改表单,向 Google 报告这些更改。
令牌审核团队拒绝了我的申请
令牌审核团队会检查您在申请 Google Ads API 访问权限时所提供的信息,以确保您的软件符合 Google Ads API 条款及条件 (T&C) 以及最低功能要求 (RMF)(如果适用)。
申请遭到拒绝的常见原因包括:
- 我们无法通过您提供的联系电子邮件地址与您联系。
- 您已经申请了权限,因为您使用的第三方工具需要开发者令牌。
- 您的申请违反条款及条件中的其他规定。
- 您的应用没有实现“最低功能要求”中必需的元素(如果适用)。
如果您更改了 API 工具以遵守 Google Ads API 政策,或者您认为我们错误地拒绝了您的申请,可以点击经理帐号的 API 中心页面中的重新申请链接,重新申请。
如果您在预计的时间内未收到我们发送的有关您的申请的电子邮件,请联系 Google Ads API 合规性审查团队。
结算
使用 Google Ads API 无需支付任何费用。对于违反“最低功能要求”的行为,我们会收取违规费用。如需了解更多详情,请参阅价目表。