向 ReachPlanService 发出的请求必须提供 OAuth 凭据以及您的 OAuth 凭据可以访问的客户 ID。此外,与您的 OAuth 凭据关联的 Google Cloud 项目必须获得批准才能使用此服务。
本指南介绍了特定于 ReachPlanService 的身份验证详细信息。如果您尚未完成使用入门中概述的步骤,请先完成这些步骤,然后再返回本指南。
OAuth 凭证
除了使用入门中提供的指南之外,请注意以下几点:
- 您的 Google Cloud 项目编号必须添加到相应的许可清单中,才能连接到
ReachPlanService,即使该项目编号已获准用于其他 Google Ads API 服务也是如此。如需了解详情,请参阅资格要求。 - 您必须接受《Google Ads API 服务条款》才能连接到 Google Ads API。
- 拥有 OAuth 刷新令牌的用户决定了您可以在
ReachPlanService中查询哪些客户 ID。这会影响您的集成,以下各部分将对此进行更详细的说明。
客户 ID
Google Ads API 中的大多数服务都针对特定的 Google Ads 账号和广告系列运行。因此,大多数请求都需要提供用于标识目标账号的客户 ID,以及有权访问该客户 ID 的 OAuth 凭证。
不过,ReachPlanService 适用于在您建立用于投放广告系列的特定客户账号之前可能发生的视频策划活动。
内部工具
如果您构建工具供组织内部使用,请考虑以下选项:
- 没有直接客户账号访问权限的规划师:如果您的规划师无权访问客户的 Google Ads 账号,请使用单用户身份验证流程为有权访问您经理账号的用户生成 OAuth 凭证。然后,为使用您工具的每个团队创建或获取一个 Google Ads 账号,并将其与您的经理账号相关联。向
ReachPlanService发出请求时,请提供与用户团队对应的客户 ID。 - 拥有客户账号访问权限的规划师:如果您的规划师有权访问管理客户账号的 Google Ads 经理账号,请实现多用户身份验证流程,以便您的应用使用规划师的 OAuth 凭据。然后,您可以传递与客户方案对应的客户 ID。
外部工具
如果您为第三方或外部用户构建工具,我们建议您选择以下选项:
- 客户账号:使用单用户身份验证流程为有权访问您经理账号的用户生成 OAuth 凭证。为每个外部客户创建一个 Google Ads 账号,并将其与您的经理账号相关联。请配置您的工具,使其在生成方案时提供客户的相应客户 ID。
- 用户授予的访问权限:允许用户使用多用户身份验证流程向您的工具授予对其账号的访问权限。用户授予权限后,使用
CustomerService检索他们可以访问的 Google Ads 账号列表。
在集成 API 之前,请根据您的系统要求选择上述方法之一,并确定一些测试客户 ID。如有疑问,请先使用关联的账号的单用户身份验证流程。
后续步骤
了解如何指定媒体策划方案。