关联产品账号

Google Ads API 支持将 Google Ads 帐号与其他产品帐号相关联。本指南介绍了如何使用 v16 版 API 来关联您的帐号。

关联账号的方法

将 Google Ads 帐号与其他产品帐号相关联时，可以通过两种不同的方式进行关联。

邀请流程

如果您拥有 Google Ads 帐号（而不是产品帐号）的管理员访问权限，则可以使用邀请流程。此流程适用于两种场景：

1. 您希望关联这两个帐号并为产品帐号的管理员创建邀请。产品帐号管理员接受完成帐号关联流程的邀请。
2. 产品帐号管理员想要关联这两个帐号，但无权访问 Google Ads 帐号。产品帐号管理员创建一个邀请，您接受邀请并完成关联过程。

在这种情况下，会用到以下方法：

场景	操作	备注
场景 1	创建邀请	使用 ProductLinkInvitationService.CreateProductLinkInvitation 方法创建邀请。不应设置 ProductLinkInvitation 的 status；API 调用成功完成后，Google Ads API 服务器会将此字段设置为 REQUESTED。
	检查邀请状态	使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 查询 product_link_invitation 资源并检查其状态。
场景 2	检索邀请	使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 查询 product_link_invitation 资源。过滤出 status = PENDING_APPROVAL 以接受或拒绝待处理的邀请。
	接受或拒绝邀请	使用 ProductLinkInvitationService.UpdateProductLinkInvitation 方法将 ProductLinkInvitation 的状态更新为 ACCEPTED 或 REJECTED。
	撤消邀请	使用 ProductLinkInvitationService.RemoveProductLinkInvitation 方法撤消现有的 ProductLinkInvitation。

此工作流可能会引发以下常见错误：

错误代码	解释
ProductLinkInvitationError.PERMISSION_DENIED	客户无权执行此操作。
ProductLinkError.NO_INVITATION_REQUIRED	无法创建邀请，因为用户已拥有受邀账号的管理员权限。用户应使用 ProductLinkService 直接创建有效链接。

直接关联流程

如果您同时拥有 Google Ads 账号和产品账号的管理员访问权限，请使用直接关联流程。在这种情况下，您可以直接将 Google Ads 帐号与产品帐号相关联，而不是发送邀请。

在这种情况下，会用到以下方法：

操作	备注
创建有效关联	使用 ProductLinkService.createProductLink 创建 ProductLink。
停用有效关联	使用 ProductLinkService.removeProductLink 移除处于活跃状态的 ProductLink。
检索有效链接	使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 查询 product_link 资源。

此工作流中可能会引发以下常见错误：

错误代码	解释
ProductLinkError.CREATION_NOT_PERMITTED	已尝试使用直接关联流程尝试进行账号关联，但由于缺少权限，此操作不受支持。用户应改用 ProductLinkInvitationService 来执行邀请流程。
ProductLinkError.INVITATION_EXISTS	已有待处理的邀请，因此无法创建链接。

AccountLinkService 和 MerchantCenterLinkService 的变化

如果您过去使用 MerchantCenterLinkService 或 AccountLinkService 将 Google Ads 帐号与其他产品帐号相关联，则需要将现有应用迁移到前面列出的某个工作流。下表显示了迁移状态：

链接类型	新服务是否支持？	支持服务开始日期	备注
DataPartnerIdentifier	是	v15	从 MerchantCenterLinkService 迁移
GoogleAdsIdentifier	是	v16	从 AccountLinkService 迁移
MerchantCenterIdentifier	是	v16	从 AccountLinkService 迁移
AdvertisingPartnerIdentifier	是	v16	从 AccountLinkService 迁移
ThirdPartyAppAnalyticsLinkIdentifier	不支持	–	继续使用 AccountLinkService