連結產品帳戶

Google Ads API 支援將 Google Ads 帳戶連結至其他產品帳戶。本指南說明如何使用 API 第 16 版來連結帳戶。

將 Google Ads 帳戶連結至其他產品帳戶時,有兩種不同的方式可以進行連結。

邀請流程

若您擁有 Google Ads 帳戶的管理員存取權,但沒有產品帳戶的管理員存取權,系統就會使用邀請流程。此流程適用於兩種情況:

  1. 您想要連結這兩個帳戶,並為產品帳戶管理員建立邀請。產品帳戶管理員會接受邀請完成帳戶連結程序。
  2. 產品帳戶管理員想連結這兩個帳戶,但無權存取 Google Ads 帳戶。產品帳戶管理員會建立邀請,讓您接受邀請並完成連結程序。

在這種情況下,我們會使用下列方法:

情境 動作 附註
情境 1: 建立邀請 使用 ProductLinkInvitationService.CreateProductLinkInvitation 方法建立邀請。 ProductLinkInvitationstatus 不應設定;Google Ads API 伺服器會在成功完成 API 呼叫後,將這個值設為 REQUESTED
查看邀請狀態 使用 GoogleAdsService.SearchGoogleAdsService.SearchStream 查詢 product_link_invitation 資源並檢查其狀態。
情境 2: 擷取邀請 使用 GoogleAdsService.SearchGoogleAdsService.SearchStream 查詢 product_link_invitation 資源。篩選 status = PENDING_APPROVAL 即可接受或拒絕待回覆的邀請。
接受或拒絕邀請 使用 ProductLinkInvitationService.UpdateProductLinkInvitation 方法,將 ProductLinkInvitation 的狀態更新為 ACCEPTEDREJECTED
撤銷邀請 使用 ProductLinkInvitationService.RemoveProductLinkInvitation 方法撤銷現有的 ProductLinkInvitation

這個工作流程可能會擲回下列常見錯誤:

錯誤代碼 說明
ProductLinkInvitationError.PERMISSION_DENIED 客戶沒有執行這項操作的權限。
ProductLinkError.NO_INVITATION_REQUIRED 使用者已具備受邀帳戶的管理員存取權,因此無法建立邀請。使用者應使用 ProductLinkService 直接建立有效連結。

直接連結流程

如果您同時擁有 Google Ads 帳戶和產品帳戶的管理員存取權,系統就會使用「直接連結」流程。在這種情況下,您可以直接將 Google Ads 帳戶連結至產品帳戶,而不是傳送邀請。

在這種情況下,我們會使用下列方法:

動作 附註
建立有效連結 使用 ProductLinkService.createProductLink 建立 ProductLink
停用有效連結 使用 ProductLinkService.removeProductLink 移除使用中的 ProductLink
擷取有效連結 使用 GoogleAdsService.SearchGoogleAdsService.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