خدمة المستودع المحلي

نودّ إطلاعك على الإصدار التجريبي من Merchant API. إنّه الإصدار الجديد من Content API for Shopping والمستقبل.

للحصول على معلومات حول كيفية تحسين عملية الدمج باستخدام Merchant API وكيفية المساعدة في صياغة المستقبل، يمكنك الاطّلاع على الإعلان عن الإصدار التجريبي من Merchant API.

تتيح لك خدمة المنتجات المتوفرة داخل المتجر إنشاء مثيلات لمورد المنتجات المتوفرة داخل المتجر وتعديلها، وهي تتضمّن حقولاً يمكن أن تحتوي على قيم مختلفة للمواقع الجغرافية للمتاجر المختلفة. إنّ كل مثيل من مستودع المنتجات المتوفرة داخل المتجر هو عنصر فرعي من مورد منتجات حالي، ويكتسب حقول بيانات المنتجات من المورد الرئيسي. على سبيل المثال، قد يكون لديك منتج يختلف السعر والكمية في متاجر مختلفة، لكنّه يتشارك المعرّف والوصف وبيانات منتج أخرى في كل المتاجر. تُستخدَم بيانات المنتجات المتوفرة داخل المتجر لبرنامجي منصات Google المحلية والإعلانات للمنتجات داخل المتجر.

يشرح هذا الدليل ما تحتاج إليه قبل البدء في استخدام خدمة المنتجات المتوفرة داخل المتجر، ويصف الحقول والطرق المتاحة، ويقدِّم مثالاً على طلب خدمة.

ملاحظة: في الإصدار 2.1 من Content API، ستحلّ خدمة المنتجات المتوفرة داخل المتجر والخلاصات التكميلية محلّ خدمة المستودع في الإصدار 2. لإجراء تعديلات جزئية على بيانات المنتجات غير المحلية باستخدام الإصدار 2.1 من واجهة برمجة التطبيقات، يمكنك استخدام الخلاصات التكميلية. لإجراء تعديلات تكميلية على المنتجات المحلية، يمكنك استخدام localinventory الخدمة.

المتطلّبات الأساسية

• لاستخدام خدمة المنتجات المتوفرة داخل المتجر، يجب إنشاء ملف تجاري وربط ملفك التجاري بحسابك على Merchant Center وإثبات ملكية نشاطك التجاري وإعداد رموز المتاجر في "الملف التجاري".

• يجب أن يكون حسابك على Merchant Center مسجّلاً في برنامج محلي: إما منصات Google المحلية أو إعلانات للمنتجات داخل المتجر. لمزيد من المعلومات عن استخدام إعلانات المنتجات داخل المتجر عبر Content API، اطّلِع على بدء استخدام إعلانات المنتجات داخل المتجر.

  ملاحظة: إذا لم يكن حسابك على Merchant Center مسجَّلاً في برنامج محلي، يؤدي ضبط الحقل channel لمنتج معيّن على local باستخدام الطريقة Products.insert إلى ظهور الخطأ: "channel غير صالحة القناة: محلية".

• تنشئ خدمة المنتجات المتوفرة داخل المتجر نُسخًا متوفّرة داخل المتجر للمنتجات المحلية الحالية. يجب أولاً إنشاء منتجات محلية باستخدام خدمة المنتجات في Content API أو خلاصات البيانات في Merchant Center، وذلك من خلال ضبط الحقل channel على local. يمكنك بعد ذلك استخدام خدمة المنتجات المتوفرة داخل المتجر لإنشاء نُسخ من المنتجات المتوفرة داخل المتجر لكل ملف تجاري storecode يتم بيع المنتج فيه.

الحقول

تحتوي كل نسخة من المنتجات المتوفرة داخل المتجر على مجموعة من الحقول المرتبطة بموقع جغرافي لمتجر معيّن عبر الحقل storeCode (الذي تحدّده في ملفك التجاري). فقط storecode وproductId هما مطلوبتان لجميع الطلبات. وجميع الحقول الأخرى اختيارية:

• مطلوبان لجميع الطلبات: storeCode وproductId (في عنوان URL)
• إجراء اختياري: quantity وprice وsalePrice وsalePriceEffectiveDate وavailability وpickupMethod وpickupSla وinstoreProductLocation

للحصول على قائمة كاملة بحقول المنتجات المتوفرة داخل المتجر وأوصافها، يمكنك الانتقال إلى الصفحة المرجعية localinventory.

الطُرق

تتضمّن خدمة المنتجات المتوفرة داخل المتجر طريقتَين فقط:

localinventory.insert

تتيح لك السمة localinventory.insert إنشاء مثيل للمنتجات المتوفّرة داخل المتجر لمنتج محلي واحد.

يوضّح هذا المثال كيفية استخدام خدمة المنتجات المتوفرة داخل المتجر من أجل إنشاء تخفيض في المتجر من 24 شباط (فبراير) 2021 الساعة 1:00 بعد الظهر (بتوقيت غرينتش) حتى 28 شباط (فبراير) 2021 الساعة 3:30 بعد الظهر (غرينيتش -8). ويعدّل الطلب أيضًا الكمية المتاحة لمثيل المنتجات المتوفرة داخل المتجر. وعلى عكس الخلاصات التكميلية لبيانات المنتجات غير المحلية، يتم استبدال الحقول غير المضمّنة في نص الطلب بواسطة هذه المكالمة:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

تتيح لك السمة localinventory.custombatch إنشاء عدة مثيلات للمنتجات المتوفرة داخل المتجر لمنتج محلي واحد في متاجر متعددة، أو إنشاء مثيلات المنتجات المتوفرة داخل المتجر لمنتجات محلية متعددة.

ملاحظة: لا يمكن استرداد أمثلة المنتجات المتوفرة داخل المتجر أو إدراجها أو حذفها. للاطّلاع على بيانات المنتجات المتوفرة داخل المتجر في Merchant Center، اختَر منتجًا محليًا في صفحة كل المنتجات ثم وسِّع قسم المنتجات المتوفرة داخل المتجر. يعرض الجدول بيانات المنتجات المتوفرة داخل المتجر لكل رمز متجر.