Ánh xạ trường

Sử dụng thông tin 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 của bạn từ Google Ads API lên Data Manager API:

Xác thực

Data Manager API yêu cầu thông tin xác thực có phạm vi khác với Google Ads API. Bạn phải tạo thông tin xác thực mới, bao gồm cả phạm vi Data Manager API để quản lý các đường liên kết của đối tác.

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

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

ProductLink (Google Ads API) 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, đồng thời đặt account_type và account_id để xác định tài khoản được liên kết.
product_link_id partner_link_id
resource_name name

Trong API Google Ads, 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 ProductLink, bạn cho biết chủ sở hữu của đường liên kết bằng cách đặt customer_id của CreateProductLinkRequest.

Trong Data Manager API, sự kết hợp giữa accountType và accountId của owning_account cho biết chủ sở hữu tài khoản nào sở hữu một mối liên kết hiện có. Khi tạo 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 định dạng tên tài nguyên khác với Google Ads API.

API Google Ads

Trong Google Ads API, 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}

Liên kết các mối liên kết của yêu cầu quản lý

Sử dụng các mối liên kết 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 của đối tác.

Tạo yêu cầu

Dưới đây là thông tin liên kết trường để chuyển đổi một CreateProductLinkRequest trong Google Ads API thành CreatePartnerLinkRequest tương đương trong Data Manager API.

CreateProductLinkRequest (Google Ads API) 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 phần Liên kết trường đối tượng

Xóa yêu cầu

Dưới đây là thông tin liên kết trường để chuyển đổi một RemoveProductLinkRequest trong Google Ads API thành DeletePartnerLinkRequest tương đương trong Data Manager API.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) Ghi chú
customer_id Không có thành phần tương đương. Trường name bao gồm tài khoản sở hữu và tài khoản đối tác, nên 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.

Liên kết các mối liên kết của yêu cầu truy xuất

Cách truy xuất đường liên kết của đối tác giữa Google Ads API và Data Manager API là khác nhau.

API Google Ads

Gửi 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 nào sẽ được trả về. Mệnh đề SELECT của truy vấn xác định những trường cần điền vào 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 SearchPartnerLinksRequest. Trường yêu cầu filter không bắt buộc xác định tài nguyên nào cần trả về. Phản hồi chứa tài nguyên hoàn chỉnh, với tất cả các trường được điền sẵn.

Dưới đây là thông tin liên kết trường để chuyển đổi một SearchGoogleAdsRequest trong Google Ads API thành SearchPartnerLinksRequest tương đương trong Data Manager API.

SearchGoogleAdsRequest (Google Ads API) 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 tài nguyên cần trả về. API Trình quản lý dữ liệu trả về tài nguyên hoàn chỉnh, vì vậy, không có mệnh đề tương đương với 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.