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