欄位對應

使用欄位對應，將合作夥伴連結工作流程的每個步驟從 Google Ads API 升級至 Data Manager API：

驗證

Data Manager API 需要的憑證範圍與 Google Ads API 不同。您必須產生新的憑證，其中包含管理合作夥伴連結的 Data Manager API 範圍。

物件欄位對應

請使用表格中的對應項目，將 Google Ads API 中的 ProductLink 對應至 Data Manager API 中的 PartnerLink 對等項目。

ProductLink (Google Ads API) PartnerLink (Data Manager API) 附註
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API 沒有為每種已連結帳戶類型提供個別欄位。針對所有帳戶類型，請將 partner_account 欄位設為 ProductAccount，並設定 account_type 和 account_id 來識別連結的帳戶。
product_link_id partner_link_id
resource_name name

在 Google Ads API 中，customer_id 的 resource_name ProductLink 表示哪個帳戶擁有現有連結。建立 ProductLink 時，請設定 CreateProductLinkRequest 的 customer_id，指出連結擁有者。

在 Data Manager API 中，accountType 和 accountId 的組合 owning_account 會指出哪個帳戶擁有現有連結。建立 PartnerLink 時，請將 name 設為擁有者的資源名稱，指明連結擁有者。

詳情請參閱「資源名稱」和「建立要求」。

type owning_account.account_type

資源名稱

Data Manager API 使用的資源名稱格式與 Google Ads API 不同。

Google Ads API

在 Google Ads API 中，ProductLink資源名稱的格式如下：

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

在 Data Manager API 中，PartnerLink 資源名稱的格式為：

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

連結管理要求對應

請使用本節中的要求對應，轉換建立、刪除及擷取合作夥伴連結的要求。

建立要求

以下是欄位對應，可將 Google Ads API 中的 CreateProductLinkRequest 轉換為 Data Manager API 中的對等 CreatePartnerLinkRequest。

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) 附註
customer_id parent 設為擁有廣告主帳戶的資源名稱。
product_link partner_link 設為 PartnerLink 資源。請參閱「物件欄位對應」一文。

刪除申請

以下是欄位對應，可將 Google Ads API 中的 RemoveProductLinkRequest 轉換為 Data Manager API 中的對等 DeletePartnerLinkRequest。

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) 附註
customer_id 沒有效果相當的功能。 name 欄位會封裝擁有者和合作夥伴帳戶， 因此不需要這個額外欄位。
resource_name name 設為要移除的 PartnerLink 資源名稱。
validate_only 沒有效果相當的功能。

連結擷取要求對應

Google Ads API 和 Data Manager API 擷取合作夥伴連結的方法不同。

Google Ads API

傳送包含 query 的 SearchGoogleAdsRequest。查詢的選用 WHERE 子句會定義要傳回的資源。查詢的 SELECT 子句會定義要在傳回的部分資源中填入哪些欄位。

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

傳送 SearchPartnerLinksRequest。 選用的 filter 要求欄位會定義要傳回的資源。 回應包含完整資源，且所有欄位都已填入資料。

以下是欄位對應，可將 Google Ads API 中的 SearchGoogleAdsRequest 轉換為 Data Manager API 中的對等 SearchPartnerLinksRequest。

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) 附註
customer_id parent 設為要搜尋的帳戶資源名稱。
page_size page_size
page_token page_token
query filter 設定 filter，定義要傳回的資源。Data Manager API 會傳回完整資源，因此沒有與 SELECT 子句對應的項目。
search_settings 沒有效果相當的功能。
validate_only 沒有效果相當的功能。

如要瞭解詳情，包括如何建構 filter 的 SearchPartnerLinksRequest 要求，以及為不同情境設定要求標頭，請參閱「擷取合作夥伴連結」。

上一頁
升級步驟