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 liên kết bị 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 trả về danh sách tất cả các đường liên kết này cho 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ỳ thông số nào và được gọi bằng yêu cầu GET HTTP.
Trạng thái dịch vụ
Khi liệt kê các đường liên kết, câu trả lời sẽ hiển thị 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ả dịch vụ được liệt kê hoặc chỉ một số dịch vụ trong số những dịch vụ được đề xuất trong yêu cầu.
Các 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, dịch vụ sẽ có trạng thái active.
Các dịch vụ đã xoá sẽ hiển thị trạng thái inactive nếu có các dịch vụ pending hoặc active khác. Sau khi tất cả dịch vụ bao gồm 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 cách sử dụ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ẻ có trạng thái pending.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
Phần tiếp theo mô tả cách phê duyệt yêu cầu liên kết.