إدراج الروابط

يمكن أن تتضمّن كلّ من شركاء Shopping وحسابات التجّار الفردية روابط متعدّدة تم الإبلاغ عنها بين حساباتهم وحسابات أخرى. تعرض الطريقة listlinks قائمة بجميع هذه الروابط لحساب Merchant Center الذي يجري طلب بيانات من واجهة برمجة التطبيقات. لا يتطلّب الأمر أي معلَمات ويتم استدعاؤه باستخدام طلب GET HTTP.

حالة الخدمة

عند إدراج الروابط، ستعرض الردود رمز status لكل service بشكل فردي داخل رابط. بإمكان التجّار الموافقة على جميع الخدمات المدرَجة أو على مجموعة فرعية منها فقط تلك المقترَحة في الطلب.

تبدأ الخدمات بحالة pending إلى أن يوافق عليها التاجر صراحةً. بعد الموافقة على الخدمات، ستظهر حالة "active".

أمّا الخدمات التي تمت إزالتها، فتعرض الحالة inactive في حال توفُّر خدمات أخرى من pending أو active أيضًا. بعد إزالة جميع الخدمات التي تتضمّن رابطًا، لن يتم عرض الرابط مرة أخرى باستخدام الطريقة 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"
        }
    ]
}

يوضّح القسم التالي كيفية الموافقة على طلب ربط الحساب.