請使用欄位對應,將合作夥伴連結工作流程的每個步驟,從 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) |
附註 |
|---|---|---|
|
partner_account |
Data Manager API 沒有為每種已連結帳戶類型提供個別欄位。不論帳戶類型為何,請將 partner_account 欄位設為 ProductAccount,並設定 account_type 和 account_id,以識別已連結帳戶。 |
product_link_id |
partner_link_id |
|
resource_name |
name |
在 Google Ads API 中,
在 Data Manager API 中, |
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,以及如何為不同情境設定要求標頭,請參閱「擷取合作夥伴連結」。