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

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

يشرح هذا الدليل المتطلبات اللازمة قبل بدء استخدام المنتجات المتوفرة داخل المتجر. ويصف الحقول والطرق المتاحة ويقدم مثالاً طلب خدمة.

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

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

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

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

الحقول

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

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

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

الطُرق

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

localinventory.insert

localinventory.insert تتيح لك إنشاء مثيل مستودع محلي لمنتج محلي واحد.

يعرض هذا المثال كيفية استخدام خدمة المنتجات المتوفرة داخل المتجر من أجل إنشاء تخفيض في المتجر من 24 فبراير 2021 الساعة 1:00 بعد الظهر (بتوقيت غرينتش -8) حتى 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 إنشاء مثيلات متعددة للمنتجات المتوفرة داخل المتجر في جهاز واحد منتج محلي في متاجر متعددة، أو إنشاء مثيلات المنتجات المتوفرة داخل المتجر المنتجات المحلية المتعددة.