关联产品账号

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

关联账号的方式

将 Google Ads 账号与其他产品账号相关联时，关联方式有两种。

注意 ：以下步骤简要介绍了将 Google Ads 账号与产品账号相关联的一般流程。对于 Merchant Center 账号，必须使用 Merchant Center 界面或 Merchant API发起新的关联 请求。Google Ads API 可用于管理（批准、拒绝、移除）和报告 Merchant Center 关联和邀请。

邀请流程

如果您拥有 Google Ads 账号的管理员访问权限，但没有产品账号的管理员访问权限，请使用邀请流程。此流程适用于以下两种情况：

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

在这种情况下，请使用以下方法：

场景	操作	备注
场景 1	创建邀请	使用 ProductLinkInvitationService.CreateProductLinkInvitation 方法 创建邀请。不应设置 status 的 ProductLinkInvitation；Google Ads API 服务器 会在 API 调用成功完成后将其设置为 REQUESTED。从 v25 开始，为广告合作伙伴 (AdvertisingPartnerLinkInvitationIdentifier) 创建邀请时，需要 advertising_partner_properties.allowed_domain （在 v24 及更早版本中为可选）。
	检查邀请的状态	使用 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	客户无权执行此操作。
ProductLinkInvitationError.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	由于存在待处理的邀请，因此无法创建关联。

检索现有产品关联

您可以使用针对 product_link 资源的 GAQL 查询检索与您的 Google Ads 账号关联的所有产品关联。

SELECT
  product_link.product_link_id,
  product_link.type
FROM product_link

product_link.type 字段表示关联的产品或服务的类型。根据 type，product_link 资源中的其他字段将会填充，以提供有关关联的更多详细信息。例如，如果类型为 DATA_PARTNER，则 data_partner 字段将包含有关关联的数据合作伙伴账号的信息。

这样，您就可以获取直接关联到您的 Google Ads 账号的外部服务和产品账号的列表，例如 Merchant Center、Google Ads、广告合作伙伴或数据合作伙伴。

对 AccountLinkService 的更改

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

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier
• DataPartnerIdentifier

对于 ThirdPartyAppAnalyticsLinkIdentifier，请继续使用 AccountLinkService。