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。

外部工具

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

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

后续步骤

了解如何指定媒体策划方案。