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