共享别名

使用 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 经理帐号。此帐号就是您的开发者令牌所在的帐号。
  • 前往工具和设置 > API 中心
  • 点击 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 调用。