Cả đối tác mua sắm và tài khoản người bán cá nhân đều có thể có nhiều đường liên kết được gắn cờ giữa tài khoản của họ và các tài khoản khác.
Phương thức listlinks
sẽ trả về danh sách tất cả các đường liên kết này đối với tài khoản Merchant Center thực hiện lệnh gọi API. Phương thức này không yêu cầu bất kỳ tham số nào và được gọi bằng yêu cầu HTTP GET
.
Trạng thái dịch vụ
Khi liệt kê các đường liên kết, các phản hồi sẽ hiển thị một status
cho từng service
riêng lẻ trong một đường liên kết. Người bán có thể phê duyệt tất cả các dịch vụ đã liệt kê hoặc chỉ một số dịch vụ được đề xuất trong yêu cầu.
Dịch vụ bắt đầu ở trạng thái pending
cho đến khi được người bán phê duyệt một cách rõ ràng. Sau khi được phê duyệt, các dịch vụ sẽ có trạng thái active
.
Các dịch vụ đã bị xoá sẽ hiển thị trạng thái inactive
nếu còn có các dịch vụ pending
hoặc active
khác. Sau khi tất cả các dịch vụ chứa một đường liên kết đã bị xoá, đường liên kết đó sẽ không còn được phương thức listlinks
trả về nữa.
Yêu cầu mẫu
Để liệt kê yêu cầu liên kết do đối tác 123456789
gửi, hãy gửi yêu cầu GET
không có tham số bằng phương thức listlinks
.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
Ví dụ về phản hồi
Trong ví dụ này, người bán 98765
chưa phê duyệt yêu cầu, vì vậy, các dịch vụ riêng lẻ sẽ có trạng thái pending
.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
Mục tiếp theo mô tả cách phê duyệt một yêu cầu liên kết.