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