合作伙伴链接概览

合作伙伴关联是一种机制,可让数据合作伙伴使用有权访问数据合作伙伴账号的 Google 账号的凭据,管理广告客户账号中的受众群体或事件。使用合作伙伴关联是要求使用有权直接访问广告客户账号的 Google 账号的凭据的替代方案。

我们建议您与 Google 代表合作,让广告客户能够在 Google Ads、Display &Video 360 或 Google Ad Manager 界面中管理与您的数据合作伙伴账号的合作伙伴关联。如果界面中没有用于管理与数据合作伙伴账号的关联的功能,或者数据合作伙伴希望在其 应用中提供合作伙伴关联功能,则只需使用 PartnerLinkService来创建或删除 关联。

与直接访问方法相比,数据合作伙伴使用合作伙伴关联来管理广告客户账号具有以下优势。

合作伙伴关联 直接访问
广告客户账号的权限范围较窄的凭据 仅允许创建或删除合作伙伴关联的凭据。 允许更改广告客户账号的许多方面的权限范围较广的凭据。
凭据管理

在广告客户账号中创建合作伙伴关联后,所有 后续请求都使用有权访问数据合作伙伴账号的 Google 账号的 一组 凭据。

广告客户账号的凭据是 短期 的。您可以在使用这些凭据创建合作伙伴关联后将其废弃。

需要为 每个广告客户账号 提供 单独的 凭据。

广告客户账号的凭据是 长期 的。您必须 安全地存储每个广告客户的凭据,然后在 想要管理该广告客户的受众群体或事件时,安全地检索每个广告客户的特定凭据。

更改历史记录 清楚地标识数据合作伙伴所做的更改。与每项更改关联的用户是数据合作伙伴账号中的 Google 账号。 数据合作伙伴所做的更改与凭据关联的 广告客户 Google 账号相关联, 因此很难区分广告客户所做的更改与数据合作伙伴代表广告客户所做的更改。

数据合作伙伴工作流程

以下是数据合作伙伴使用合作伙伴关联来管理广告客户账号的步骤:

  1. 获取广告客户账号的凭据

  2. 使用广告客户账号的凭据 创建合作伙伴关联

  3. 废弃广告客户账号的凭据。既然您已创建合作伙伴关联,现在就不需要这些凭据了。

  4. 对于所有后续请求 ,如需管理广告客户账号中的受众群体或事件,请使用 数据合作伙伴账号 中用户的 Google 账号的凭据。 配置目标位置和标头 以便使用合作伙伴关联访问广告客户账号。

获取广告客户账号的凭据

如需创建或删除合作伙伴关联,您需要广告客户账号中用户的 Google 账号的凭据,且凭据具有以下权限范围:

https://www.googleapis.com/auth/datamanager.partnerlink

此权限范围提供有限的访问权限,专门用于在广告客户账号中创建或删除合作伙伴关联。由于此权限范围属于敏感权限范围,因此您必须 完成 应用验证 流程,以避免出现未经验证的 应用屏幕

如需获取广告客户账号的凭据,请构建自己的 OAuth 流程来验证用户身份。Google Identity 文档中讨论了多种应用类型,以及支持每种应用类型所需的配置。Data Manager API 支持所有这些应用类型,但我们建议使用针对网络服务器应用的 OAuth 2.0针对客户端 Web 应用的 OAuth 2.0来获取广告客户凭据,以便创建合作伙伴关联。

完成该流程后,请将应用配置为针对合作伙伴关联权限范围进行身份验证:

https://www.googleapis.com/auth/datamanager.partnerlink