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

يمكن أن يتضمّن كلّ من شركاء 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"
        }
    ]
}

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