Ánh xạ trường

Sử dụng các mối liên kết trường để nâng cấp từng bước trong quy trình liên kết đối tác từ API Google Ads lên Data Manager API:

Liên kết trường đối tượng

Sử dụng các mối liên kết trong bảng để liên kết một ProductLink trong API Google Ads với PartnerLink tương đương trong Data Manager API.

ProductLink (API Google Ads) PartnerLink (Data Manager API) Ghi chú
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API không có các trường riêng biệt cho từng loại tài khoản được liên kết. Đối với tất cả các loại tài khoản, hãy đặt trường partner_account thành ProductAccount và đặt account_type và account_id của trường này để xác định tài khoản được liên kết.
product_link_id partner_link_id
resource_name name

Trong Google Ads API, customer_id của resource_name của ProductLink cho biết tài khoản nào sở hữu một mối liên kết hiện có. Khi tạo một ProductLink, bạn chỉ định chủ sở hữu của mối liên kết bằng cách đặt customer_id của một CreateProductLinkRequest.

Trong Data Manager API, tổ hợp accountType và accountId của owning_account cho biết tài khoản nào sở hữu một mối liên kết hiện có. Khi tạo một PartnerLink, bạn cho biết chủ sở hữu của đường liên kết bằng cách đặt name thành tên tài nguyên của chủ sở hữu.

Hãy xem phần Tên tài nguyên và Tạo yêu cầu để biết thông tin chi tiết.

type owning_account.account_type

Tên tài nguyên

Data Manager API sử dụng một định dạng tên tài nguyên khác với Google Ads API.

API Google Ads

Trong API Google Ads, tên tài nguyên ProductLink sử dụng định dạng:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Trong Data Manager API, tên tài nguyên PartnerLink sử dụng định dạng:

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

Mối liên kết giữa yêu cầu quản lý việc liên kết

Sử dụng các ánh xạ yêu cầu trong phần này để chuyển đổi các yêu cầu tạo, xoá và truy xuất đường liên kết đối tác.

Tạo yêu cầu

Sau đây là các mối liên kết trường để chuyển đổi CreateProductLinkRequest trong API Google Ads thành CreatePartnerLinkRequest tương đương trong Data Manager API.

CreateProductLinkRequest (API Google Ads) CreatePartnerLinkRequest (Data Manager API) Ghi chú
customer_id parent Đặt thành tên tài nguyên của tài khoản nhà quảng cáo sở hữu.
product_link partner_link Đặt thành tài nguyên PartnerLink. Xem Liên kết trường đối tượng

Xóa yêu cầu

Sau đây là các mối liên kết trường để chuyển đổi RemoveProductLinkRequest trong API Google Ads thành DeletePartnerLinkRequest tương đương trong Data Manager API.

RemoveProductLinkRequest (API Google Ads) DeletePartnerLinkRequest (Data Manager API) Ghi chú
customer_id Không có thành phần tương đương. Trường name bao bọc các tài khoản sở hữu và tài khoản đối tác, vì vậy, bạn không cần trường bổ sung này.
resource_name name Đặt thành tên tài nguyên của PartnerLink mà bạn muốn xoá.
validate_only Không có thành phần tương đương.

Ánh xạ yêu cầu truy xuất đường liên kết

Phương pháp truy xuất đường liên kết đối tác khác nhau giữa API Google Ads và API Trình quản lý dữ liệu.

API Google Ads

Gửi một SearchGoogleAdsRequest chứa query. Mệnh đề WHERE không bắt buộc của truy vấn xác định tài nguyên cần trả về. Mệnh đề SELECT của truy vấn xác định những trường cần điền vào các tài nguyên một phần được trả về.

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

Gửi SearchPartnerLinkRequest. Trường yêu cầu filter (không bắt buộc) xác định những tài nguyên cần trả về. Phản hồi chứa các tài nguyên hoàn chỉnh, với tất cả các trường được điền sẵn.

Sau đây là các mối liên kết trường để chuyển đổi SearchGoogleAdsRequest trong API Google Ads thành SearchPartnerLinksRequest tương đương trong Data Manager API.

SearchGoogleAdsRequest (API Google Ads) SearchPartnerLinksRequest (Data Manager API) Ghi chú
customer_id parent Đặt thành tên tài nguyên của tài khoản cần tìm kiếm.
page_size page_size
page_token page_token
query filter Đặt filter để xác định những tài nguyên cần trả về. Data Manager API trả về các tài nguyên hoàn chỉnh, nên không có tài nguyên nào tương đương với mệnh đề SELECT.
search_settings Không có thành phần tương đương.
validate_only Không có thành phần tương đương.

Hãy xem bài viết Truy xuất đường liên kết của đối tác để biết thêm thông tin, bao gồm cả cách tạo filter của yêu cầu SearchPartnerLinksRequest và đặt tiêu đề yêu cầu cho các trường hợp khác nhau.

Trước
Các bước nâng cấp