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

يمكن أن يكون لدى شركاء 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"
        }
    ]
}

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