يمكن أن تتضمّن كلّ من شركاء 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"
}
]
}
يوضّح القسم التالي كيفية الموافقة على طلب ربط الحساب.