Authentication

ReachPlanService 的请求必须提供已获批的开发者令牌、OAuth 凭据以及您的 OAuth 凭据可以访问的客户 ID。

本指南介绍了与 ReachPlanService 相关的身份验证详细信息。如果您尚未完成使用入门中所述的步骤,请先完成这些步骤,然后再返回此处。

开发者令牌和 OAuth 凭据

除了开始使用中介绍的指南之外,请注意以下几点:

  1. 您的开发者令牌必须添加到相应的许可名单中,才能连接到 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 适用于您在知道要投放广告系列的具体客户 ID 之前可能进行的视频规划活动。

内部工具

如果您为组织内部使用构建工具,请参考以下建议。

无法直接访问客户账号的规划师

如果您的规划人员无法访问客户的 Google Ads 账号,请使用已安装的应用流程为有权访问开发者令牌的经理账号的用户生成 OAuth 凭据。然后,为使用您工具的每个团队创建或获取一个 Google Ads 账号,并将这些账号与您的经理账号相关联。在向 ReachPlanService 发出请求时,提供与用户团队对应的客户 ID。

具有客户账号访问权限的规划师

如果您的规划师有权访问管理客户账号的 Google Ads 经理账号,请实现网络应用流程,以便您的应用使用规划师的 OAuth 凭据。然后,您可以传入与您的方案客户对应的客户 ID。

外部工具

如果您为外部用户构建工具,我们建议采用类似的方法:

每个客户账号

使用已安装的应用流程为有权访问您的开发者令牌的经理账号的用户生成 OAuth 凭据。为每位外部客户创建一个 Google Ads 账号,然后将这些账号与您的经理账号相关联。然后,将工具配置为在客户生成方案时提供客户的相应客户 ID。

用户授予的访问权限

使用Web 应用流程,让用户能够向您的工具授予对其账号的访问权限。用户授予权限后,使用 CustomerService 向其提供可访问的 Google Ads 账号列表。

我们的目标是确保规划者在使用 ReachPlanService 时尽可能顺畅。在集成 API 之前,请根据您的具体情况选择以下两种方法之一,并确定几个客户 ID 以进行测试。如有疑问,请使用针对您的工具类型建议的第一种方法。

后续步骤

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