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