共享别名

在使用 Google Ads API 时,有多个位置会使用电子邮件地址来管理联系信息和访问权限,其中最重要的是:

  • Google Ads API 联系电子邮件地址:这是 Google Ads 界面 API 中心中列为联系人的电子邮件地址。
  • Google Cloud 控制台账号电子邮件地址:此电子邮件地址具有对用于 OAuth 2.0 应用的 Google Cloud 控制台账号的管理员访问权限。
  • Google Ads 经理账号电子邮件地址:这些电子邮件地址对您通过 Google Ads API 访问的经理 Google Ads 账号拥有管理员权限。为应用生成刷新令牌时,您通常需要使用其中一个电子邮件地址对 Google Ads API 应用进行身份验证。

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

Google Ads API 联系电子邮件地址

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

如需更新 API 联系电子邮件地址,请按以下步骤操作:

  1. 登录您的 Google Ads 经理账号

  2. 点击屏幕左下角的管理

  3. 经理账号设置下,点击 API 中心

  4. 开发者详细信息下,记下 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 调用的刷新令牌。