关联产品账号

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

关联账号的方式

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

邀请流程

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

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

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

场景	操作	备注
场景 1	创建邀请	使用 ProductLinkInvitationService.CreateProductLinkInvitation 方法创建邀请。不应设置 ProductLinkInvitation 的 status；Google Ads API 服务器会在成功完成 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 的变更

如果您使用 AccountLinkService 将 Google Ads 账号与其他产品账号相关联，则必须将现有申请迁移到前面列出的工作流之一。对于以下链接类型，请停用 AccountLinkService 并改用 ProductLinkService：

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

对于 ThirdPartyAppAnalyticsLinkIdentifier，请继续使用 AccountLinkService。