共享别名

使用 Google Ads API 时,可在多个位置使用电子邮件地址进行联系人和访问权限管理,最重要的是:

  • Google Ads API 联系电子邮件地址:在 Google Ads 界面的 API 中心内列为联系人的电子邮件地址。
  • Google Cloud Console 帐号电子邮件地址:此电子邮件地址,对您的 OAuth 2.0 应用所用 Google Cloud Console 帐号拥有管理员访问权限。
  • Google Ads 经理帐号电子邮件地址:这些电子邮件地址对您通过 Google Ads API 访问的 Google Ads 经理帐号拥有管理员权限。为应用生成刷新令牌时,您通常使用这类电子邮件之一对 Google Ads API 应用进行身份验证。

我们强烈建议您使用共享团队别名,以便在个别团队成员换团队或离开公司时,您不会失去对这些帐号的访问权限。本指南的其余部分详细介绍了前面列出的每封电子邮件,以及如何将其更新为使用共享的团队别名,而不是个人用户的电子邮件地址。

Google Ads API 联系人电子邮件地址

Google Ads API 联系电子邮件地址是您在注册 Google Ads API 时提供的电子邮件地址。您应确保可以访问此别名,并定期监控发送到此地址的电子邮件。在 API 审核、审核请求或需要立即注意的生产紧急情况期间,Google 会使用此电子邮件地址与您的团队联系。使用共享团队别名作为联系电子邮件地址,以确保整个团队都能收到这些通知。

请按照以下步骤更新 API 联系电子邮件地址:

  • 登录您申请 Google Ads API 访问权限时使用的 Google Ads 经理帐号。也就是您的开发者令牌所在的帐号。
  • 前往 Tools & Settings > API Center
  • 点击 API 联系电子邮件地址部分下的箭头。
  • 更新电子邮件地址,然后点击保存按钮。

Google Cloud 控制台账号

Google API 控制台项目包含应用的 OAuth 凭据,可控制对 Google Ads API 的访问权限。通过将共享别名设为帐号所有者,确保访问此帐号。

请按以下步骤更新 Google API 控制台项目所有者:

  • 登录 Google API 控制台
  • 从页面左上角的下拉菜单中选择您的项目。
  • 在左侧菜单中,依次点击 IAM 和管理 > IAM
  • 点击授予访问权限按钮。
  • 添加主账号部分下,输入共享电子邮件地址。
  • 分配 Owner 角色。
  • 点击保存按钮。请参阅 Cloud 文档,详细了解如何授予和撤消访问权限

Google Ads 经理账号

使用 Google Ads API 管理帐号的一种常用方法是,将您所有的帐号都关联到一个共同经理帐号下,然后使用最顶层经理帐号的凭据对所有帐号进行 API 调用。在本配置中:

  • 开发者使用有权访问 Google Ads 经理帐号的用户的凭据颁发刷新令牌。
  • 开发者将 login_customer_id 标头设置为 Google Ads 经理帐号的客户 ID,并将 customer_id 标头设置为进行 API 调用的帐号的客户 ID。

这种设置存在的一个潜在风险是,如果已获授权的用户失去对 Google Ads 经理帐号的访问权限,刷新令牌将失效,并且所有 API 调用都会失败。为避免这种情况,您可以邀请共享电子邮件别名以适当的访问权限级别管理此 Google Ads 经理帐号。使用此共享电子邮件别名可发出刷新令牌,以便进行 API 调用。