验证

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 之前可能发生的视频规划活动。

如果合作伙伴构建的工具供组织内部使用,我们建议选择以下某个选项:

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

  2. 如果规划人员有权访问管理客户账号的 Google Ads 经理帐号:实现 Web 应用流程以允许您的应用使用规划人员的 OAuth 凭据。然后,您可以传入与您的方案的客户对应的客户 ID。

对于为外部用户构建工具的合作伙伴,我们建议采用类似的方法:

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

  2. 使用 Web 应用流程让您的用户能够授权您的工具访问其帐号。用户授予权限后,请使用 CustomerService 向他们提供其可以访问的 Google Ads 帐号列表。

目标是确保规划人员在使用 ReachPlanService 时尽可能减少阻力。在集成 API 之前,请根据您的具体情况选择两种方法之一,并确定要测试的一些客户 ID。如有疑问,请根据您的工具类型使用第一种建议的方法。