Authentication

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

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

开发者令牌和 OAuth 凭据

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

  1. 即使您的开发者令牌已获批准可用于其他 Google Ads API 服务,您也必须将其添加到相应的允许名单中,才能连接到 ReachPlanService。如需了解详情, 请参阅资格 要求
  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。

用户授予的访问权限

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

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

后续步骤

了解如何指定媒体方案