هم شرکای خرید و هم حساب‌های تجاری منفرد می‌توانند چندین پیوند پرچم‌گذاری شده بین حساب‌های خود و دیگران داشته باشند. روش listlinks فهرستی از همه این پیوندها را برای حساب مرکز تجاری که تماس API را انجام می دهد، برمی گرداند. به هیچ پارامتری نیاز ندارد و با استفاده از درخواست HTTP GET فراخوانی می شود.
وضعیت خدمات
هنگام فهرست کردن پیوندها، پاسخ ها status برای هر service جداگانه در یک پیوند نشان می دهند. بازرگانان این گزینه را دارند که همه خدمات فهرست شده را تأیید کنند یا فقط زیرمجموعه ای از خدمات پیشنهادی در درخواست را تأیید کنند.
خدمات در وضعیت pending شروع می شوند تا زمانی که صریحاً توسط یک تاجر تأیید شود . پس از تایید، سرویس ها وضعیت active دارند.
اگر سرویس‌های pending یا active دیگری نیز وجود داشته باشد، سرویس‌های حذف شده وضعیت inactive را نشان می‌دهند. پس از حذف تمام سرویس های حاوی یک پیوند، پیوند دیگر با روش listlinks بازگردانده نمی شود.
درخواست نمونه
برای فهرست کردن درخواست پیوند ارسال شده توسط شریک 123456789 ، یک درخواست GET بدون پارامتر با استفاده از روش listlinks ارسال کنید.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
پاسخ نمونه
در این مثال، تاجر 98765 هنوز درخواست را تأیید نکرده است، بنابراین خدمات فردی وضعیت pending دارند.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
بخش بعدی نحوه تأیید درخواست پیوند را توضیح می دهد.