欄位對應

使用欄位對應，將合作夥伴連結工作流程的每個步驟從 Google Ads API 升級至資料管理工具 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 中，resource_name的 customer_idProductLink表示哪個帳戶擁有現有連結。建立 ProductLink 時，請設定 CreateProductLinkRequest 的 customer_id，指出連結擁有者。

在資料管理工具 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 和資料管理工具 API 的合作夥伴連結擷取方式不同。

Google Ads API

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

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

傳送 SearchPartnerLinkRequest。 選用的 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

上一頁
升級步驟