Để gắn cờ mối quan hệ với một tài khoản người bán, trước tiên, đối tác Mua sắm phải sử dụng phương thức accounts.link để gửi yêu cầu liên kết.
Yêu cầu liên kết chứa một linkedAccountId xác định người bán nhận được yêu cầu và có loại action là request. Mỗi đường liên kết cũng phải chỉ định một bộ services liệt kê những tính năng mà đối tác cung cấp cho người bán. Các giá trị services sau đây được hỗ trợ.
| Dịch vụ | Mô tả |
|---|---|
shoppingAdsProductManagement |
Quản lý dữ liệu sản phẩm cho quảng cáo Mua sắm |
shoppingActionsProductManagement |
Quản lý dữ liệu sản phẩm cho chương trình Mua bằng Google (trước đây gọi là Mua sắm Trực tiếp) |
shoppingActionsOrderManagement |
Quản lý đơn đặt hàng cho chương trình Mua bằng Google (trước đây gọi là Mua sắm Trực tiếp) |
Ngoài ra, yêu cầu cũng phải chứa một linkType hợp lệ mô tả loại đối tác Mua sắm đưa ra yêu cầu. Các đối tác mua sắm được chỉ định một trong những nhãn sau đây và phải sử dụng nhãn được chỉ định trong trường linkType khi gọi API.
| Valid linkTypes |
|---|
channelPartner |
eCommercePlatform |
Ví dụ:
Lệnh gọi API sau đây sẽ gửi yêu cầu liên kết từ tài khoản của đối tác 123456789 đến một người bán có linkedAccountId là "98765".
"eCommercePlatform" linkType xác định đối tác là một nền tảng thương mại điện tử. Danh sách services cho biết rằng đối tác cung cấp các tính năng "shoppingAdsProductManagement" (quản lý dữ liệu sản phẩm cho quảng cáo Mua sắm) và "shoppingActionsOrderManagement" (quản lý đơn đặt hàng cho chương trình Mua bằng Google, trước đây gọi là Mua sắm Trực tiếp).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
Phần tiếp theo mô tả cách lấy danh sách các đường liên kết hiện có.