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

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

حالة الخدمة

عند إدراج الروابط، ستعرض الردود 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"
        }
    ]
}

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