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:
- Ánh xạ trường đối tượng chứa các ánh xạ trường cho tài nguyên đại diện cho một đối tượng đường liên kết của đối tác.
- Ánh xạ yêu cầu quản lý liên kết chứa các ánh xạ trường cho yêu cầu tạo và xoá liên kết đối tác.
- Ánh xạ yêu cầu truy xuất đường liên kết chứa các ánh xạ trường để truy xuất đường liên kết của đối tác.
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ú |
|---|---|---|
|
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,
Trong Data Manager API, sự kết hợp giữa 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
ProductLinksử 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
PartnerLinksử 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
SearchGoogleAdsRequestchứaquery. Mệnh đềWHEREkhô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 đềSELECTcủ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ầufilterkhô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.