Google Ads API 支援將 Google Ads 帳戶連結至其他產品帳戶。本指南說明如何使用 API 第 16 版來連結帳戶。
連結帳戶的方式
將 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 |