لیست پیوندها

هم شرکای خرید و هم حساب‌های تجاری می‌توانند چندین لینک علامت‌گذاری شده بین حساب‌های خود و دیگران داشته باشند. متد 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"
        }
    ]
}

بخش بعدی نحوه تأیید درخواست پیوند را شرح می‌دهد.