Google Ads API 支持将 Google Ads 帐号与其他产品帐号相关联。 本指南介绍如何使用 API v16 版本来关联您的账号。
关联账号的方法
将 Google Ads 帐号与其他产品帐号相关联时，有两种不同的关联方式。
邀请流程
如果您拥有 Google Ads 账号的管理员访问权限，但没有产品账号，则系统会使用邀请流程。此流程适用于两种场景：
- 您想要关联这两个帐号，并为产品帐号的管理员创建邀请。产品账号管理员接受完成账号关联流程的邀请。
- 产品帐号管理员想要关联这两个帐号，但无权访问 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 和 MerchantCenterLinkService 的变更
如果您过去使用 MerchantCenterLinkService 或 AccountLinkService 将 Google Ads 帐号与其他产品帐号相关联，则需要将现有应用迁移到前面列出的某个工作流。下表显示了迁移状态：
| 链接类型 | 新服务是否支持？ | 提供支持服务截至 | 备注 |
|---|---|---|---|
DataPartnerIdentifier |
是 | v15 | 迁离 MerchantCenterLinkService |
GoogleAdsIdentifier |
是 | v16 | 迁离 AccountLinkService |
MerchantCenterIdentifier |
是 | v16 | 迁离 AccountLinkService |
AdvertisingPartnerIdentifier |
是 | v16 | 迁离 AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
否 | – | 继续使用 AccountLinkService |