对 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。如有疑问,请先使用单用户身份验证流程 (使用关联的账号)。
后续步骤
了解如何指定媒体规划。