Authentication

对 ReachPlanService 的请求必须提供 OAuth 凭据以及 OAuth 凭据可以访问的客户 ID。此外,与 OAuth 凭据关联的 Google Cloud 项目必须获得使用此服务的批准。

本指南介绍了特定于 ReachPlanService的身份验证详细信息。如果您尚未完成 使用入门中列出的步骤,请先完成这些步骤,然后再返回本指南。

OAuth 凭据

除了使用入门中提供的指南之外,请注意以下 几点:

  1. 您的 Google Cloud 项目编号必须添加到相应的许可名单中 才能连接到 ReachPlanService,即使该项目已 获准用于其他 Google Ads API 服务也是如此。如需了解详情, 请参阅资格要求。
  2. 您必须接受 Google Ads API 服务条款,才能连接到 Google Ads API。
  3. 拥有 OAuth 刷新令牌的用户决定了您 可以在 ReachPlanService中查询哪些客户 ID。这会影响您的集成,并且会在以下部分中进行更详细的说明。

客户 ID

Google Ads API 中的大多数服务都针对特定的 Google Ads 账号和广告系列运行。因此,大多数请求都需要客户 ID 来标识 目标账号,以及获授权访问 该客户 ID 的 OAuth 凭据。

不过,ReachPlanService 适用于视频规划 活动,这些活动可能在您建立用于 投放广告系列的特定客户账号之前发生。

内部工具

如果您构建的工具供组织内部使用,请考虑以下选项:

  • 规划师没有直接的客户账号访问权限: 如果您的规划师无权访问客户的 Google Ads 账号,请使用单用户身份验证流程为有权访问经理账号的用户生成 OAuth 凭据。然后,为使用您的工具的每个团队创建或获取一个 Google Ads 账号,并将这些账号与您的经理 账号相关联。在向 ReachPlanService发出请求时,请提供与用户团队对应的客户 ID 。
  • 规划师拥有客户账号访问权限: 如果您的规划师有权访问管理客户账号的 Google Ads 经理账号,请实现 多用户身份验证流程,以允许 您的应用使用规划师的 OAuth 凭据。然后,您可以传递与客户方案对应的客户 ID。

外部工具

如果您构建的工具供第三方或外部用户使用,我们建议您使用以下选项:

  • 每个客户账号: 使用单用户 身份验证流程为有权访问 经理账号的用户生成 OAuth 凭据。为每个外部客户创建一个 Google Ads 账号,并将这些账号与您的经理账号相关联 。将您的工具配置为在生成方案时提供客户的相应客户 ID。
  • 用户授予的访问权限: 允许用户使用多用户身份验证 流程向您的工具授予对其 账号的访问权限。用户授予权限后,请使用 CustomerService检索他们可以访问的 Google Ads 账号列表。

在集成 API 之前,请根据您的系统要求选择上述方法之一,并确定几个测试客户 ID。如有疑问,请先使用单用户身份验证流程 (使用关联的账号)。

后续步骤

了解如何指定媒体规划。