向 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。如有疑问,请根据您的工具类型使用第一种建议的方法。