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