向 ReachPlanService 发出的请求必须
提供已获批准的开发者令牌、OAuth 凭据以及
OAuth 凭据可以访问的客户 ID。
本指南介绍了特定于
ReachPlanService的身份验证详细信息。如果您尚未完成,
请先完成
开始使用中列出的步骤,然后再返回此处。
开发者令牌和 OAuth 凭据
- 即使您的开发者令牌已获批准可用于其他 Google Ads API 服务,您也必须将其添加到相应的允许名单中,才能连接到
ReachPlanService。如需了解详情, 请参阅资格 要求。 - 您必须接受《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 经理账号,请实现 多用户身份验证 流程,以允许您的应用使用您的 规划师的 OAuth 凭据。然后,您可以传入与方案客户对应的客户 ID。
外部工具
如果您构建的工具供外部用户使用,我们建议您采取类似的方法:
每个客户账号
使用 单用户身份验证 流程 为有权访问 开发者令牌的经理账号的用户生成 OAuth 凭据。为每个外部客户创建一个 Google Ads 账号,并将这些账号与您的经理 账号相关联。然后,将您的工具配置为在客户生成方案时提供客户对应的客户 ID。
用户授予的访问权限
让用户能够使用多用户身份验证
流程向您的工具授予对其账号的访问权限
。用户授予
权限后,请使用
CustomerService向其提供可访问的 Google Ads 账号列表。
我们的目标是确保规划师在使用
ReachPlanService时尽可能减少摩擦。在集成 API 之前,请根据您的具体情况选择其中一种方法,并确定几个客户 ID 进行测试。如有疑问,请针对您的工具类型使用第一种建议的方法。
后续步骤
了解如何指定媒体方案。