使用 Google Ads API 时,邮箱会在多个地方用于联系和访问管理。其中最重要的包括:
- Google Ads API 联系电子邮件地址:在您的 Google Cloud 项目中分配了所有者或编辑者角色的电子邮件地址,Google 会使用这些电子邮件地址发送重要服务通知 (MSA) 和管理通知。
- Google Cloud 控制台账号电子邮件地址:对 OAuth 2.0 应用所用的 Google Cloud 项目拥有管理员访问权限的电子邮件地址。
- Google Ads 经理账号访问权限:服务账号(推荐)或共享邮箱别名,对通过 Google Ads API 访问的 Google Ads 经理账号拥有访问权限。
本指南的其余部分将详细介绍前面列出的每个账号,以及如何配置这些账号,以便您的集成不依赖于单个用户的电子邮件地址。
Google Ads API 联系电子邮件地址
Google 会向与 Google Cloud 项目的所有者和编辑者角色关联的邮箱发送管理通知、API 审核更新、审核请求、重要服务通知 (MSA) 和生产紧急通信(请参阅新的 API 联系邮箱,因为 Google Ads 界面中的旧版 API 中心联系邮箱设置已停用)。
如需更新您的联系邮箱并确保整个团队都能收到这些通知,请向 Google Cloud 项目中的共享团队别名授予所有者或编辑者角色,并定期监控发送到该别名的电子邮件。
Google Cloud 控制台账号
Google Cloud 控制台项目包含应用的 OAuth 凭证,并控制对 Google Ads API 的访问。通过向共享团队别名授予 Owner(或 Editor)角色,确保对该项目的访问权限。
如需将共享别名添加为 Google Cloud 项目所有者,请按以下步骤操作:
- 登录 Google Cloud 控制台。
- 从页面顶部的项目选择器中选择您的项目。
- 在导航菜单中,依次前往 IAM 和管理 > IAM。
- 点击授予访问权限。
- 在添加主账号部分的新的主账号字段中,输入共享邮箱。
- 在分配角色部分,点击选择角色,然后选择基本 > Owner(或基本 > Editor)。
- 点击保存。如果您向 Google Cloud 组织外部的电子邮件地址(或无组织的项目)授予了 Owner 角色,Google Cloud 会向共享别名发送一封邮件邀请,必须接受该邀请,角色才会生效。如需详细了解如何授予和撤消访问权限,请参阅 Cloud 文档。
Google Ads 经理账号
使用 Google Ads API 管理账号的一种常见方法是,将所有账号关联到一个共同的经理账号下,并使用最顶层经理账号的凭据对所有账号进行 API 调用。在此配置中,开发者将 login-customer-id 请求标头(或 login_customer_id 客户端库配置设置)设置为 Google Ads 经理账号的 10 位数客户 ID(不带连字符),并将目标 customer_id 设置为进行 API 调用的操作账号。
推荐:使用服务账号
使用服务账号是进行身份验证和访问 Google Ads 经理账号的首选方法。与个人用户账号不同,服务账号在 Google Cloud 项目中进行管理,不与特定人员绑定,从而避免在团队成员更换角色或离职时发生服务中断。按照服务账号指南创建服务账号,并向其授予对 Google Ads 经理账号的访问权限。
替代方案:使用共享邮箱别名
如果您的集成无法使用服务账号,而是依赖于单用户身份验证工作流,则有权访问 Google Ads 经理账号的用户会签发 OAuth 2.0 刷新令牌。
如需在使用用户凭据时避免出现这种情况,请执行以下操作:
- 邀请共享邮箱别名(由已启用通行密钥验证的有效 Google 账号提供支持)以适当的访问权限级别管理此 Google Ads 经理账号。
- 使用共享邮箱别名接受邀请。
- 使用此共享邮箱别名颁发 OAuth 刷新令牌,以便进行 API 调用。