对 ReachPlanService
的请求必须提供已获批的开发者令牌、OAuth 凭据以及您的 OAuth 凭据可以访问的客户 ID。
本指南介绍了与 ReachPlanService
相关的具体身份验证详细信息。如果您尚未完成使用入门中概述的步骤,请先完成这些步骤,然后再返回此处。
开发者令牌和 OAuth 凭据
除了开始使用中介绍的指南之外,请注意以下几点:
- 您的开发者令牌必须列入许可名单,才能连接到
ReachPlanService
,即使该令牌已获批可用于其他 Google Ads API 服务也是如此。如需了解详情,请参阅资格要求。 - 您必须接受 Google Ads API 服务条款,才能连接到 Google Ads API。
- 拥有 OAuth 刷新令牌的用户决定了您可以在
ReachPlanService
中查询哪些客户 ID。这会影响您的集成,下文将对此进行更详细的说明。
客户 ID
Google Ads API 中的大多数服务都针对特定的 Google Ads 账号和广告系列运行。因此,大多数请求都需要同时提供客户 ID(用于标识您要管理或查询的账号)和有权访问该客户 ID 的 OAuth 凭据。不过,ReachPlanService
适用于在您知道要投放广告系列的具体客户 ID 之前可能发生的视频规划活动。
对于构建供组织内部使用的工具的合作伙伴,我们建议选择以下选项之一:
如果规划师无法访问客户的 Google Ads 账号:请使用已安装的应用流程为有权访问开发者令牌的经理账号的用户生成 OAuth 凭据。然后,为使用您工具的每个团队创建或获取一个 Google Ads 账号,并将这些账号与您的经理账号相关联。在向
ReachPlanService
发出请求时,提供与用户团队对应的客户 ID。如果规划师有权访问管理客户账号的 Google Ads 经理账号:请实现Web 应用流程,以允许您的应用使用规划师的 OAuth 凭据。然后,您可以传入与您的方案客户对应的客户 ID。
对于为外部用户构建工具的合作伙伴,我们建议采用类似的方法:
使用已安装的应用流程为有权访问开发者令牌的经理账号的用户生成 OAuth 凭据。为每位外部客户创建一个 Google Ads 账号,然后将这些账号与您的经理账号相关联。然后,将工具配置为在生成方案时提供客户的相应客户 ID。
通过使用Web 应用流程,让用户能够向您的工具授予对其账号的访问权限。用户授予权限后,使用
CustomerService
向其提供可访问的 Google Ads 账号列表。
我们的目标是确保规划者在使用 ReachPlanService
时尽可能顺畅。在集成 API 之前,请根据您的具体情况选择以下两种方法之一,并确定几个客户 ID 以进行测试。如有疑问,请使用针对您的工具类型建议的第一种方法。