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

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

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

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

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

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

  • تنشئ خدمة المنتجات المتوفرة داخل المتجر مثيلات للمنتجات المتوفرة داخل المتجر للمنتجات المحلية الحالية. عليك أولاً إنشاء منتجات محلية باستخدام خدمة منتجات 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 بعد الظهر (بتوقيت غرينيتش -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 تتيح لك إنشاء نُسخ متعددة من المنتجات المتوفرة داخل المتجر لمنتج محلي واحد في متاجر متعددة أو إنشاء نُسخ للمنتجات داخل المتجر لمنتجات محلية متعددة.