欄位對應

請使用欄位對應,將合作夥伴連結工作流程的每個步驟,從 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 中,ProductLink 的 resource_name customer_id 會指出哪個帳戶擁有現有連結。建立 ProductLink 時,您可以設定 CreateProductLinkRequest 的 customer_id,藉此指定連結的擁有者。

在 Data Manager API 中,owning_account 的 accountType 和 accountId 組合會指出哪個帳戶擁有現有連結。建立 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 沒有效果相當的功能。

如需更多資訊,包括如何建構 SearchPartnerLinksRequest 要求的 filter,以及如何為不同情境設定要求標頭,請參閱「擷取合作夥伴連結」。