نقل بيانات إدارة المستودع من Content API for Shopping

يمكنك استخدام Merchant API لإدارة المنتجات المتوفّرة داخل المتجر (في المتجر) والإقليمية.

الطلبات

استخدم تنسيق عنوان URL التالي للطلب الخاص بالمستودعات واجهة برمجة التطبيقات الفرعية:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories

في Merchant API، يُشار إلى واجهة برمجة التطبيقات الفرعية الخاصة بالمستودعات ونقطة النهاية ذات الصلة بها، بصيغة الجمع، "المستودعات".

إليك نموذج مقارنة بين Content API for Shopping والتاجر واجهة Inventories API لطلبات المنتجات المتوفرة داخل المتجر:

Content API واجهة برمجة تطبيقات التاجر
عنوان URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories
المعرفات {merchantId}/products/{productId} {name}

الطُرق

تقدّم Merchant API طريقتَين جديدتَين لإدارة المستودع:

  • أدرِج المنتجات المتوفرة داخل المتجر والإقليمية.
  • إزالة المنتجات المتوفرة داخل المتجر والإقليمية من منتجاتك

في ما يلي مقارنة بين طرق المستودعات في Content API for Shopping وMerchant Inventories API:

الطريقة واجهة برمجة تطبيقات المحتوى في Shopping واجهة برمجة تطبيقات التاجر
customBatch نعم لا
insert نعم نعم
list لا نعم
delete لا نعم

المنتجات المتوفرة داخل المتجر

في ما يلي التغييرات التي تم إجراؤها على المنتجات المتوفرة داخل المتجر في Merchant Inventories API:

واجهة برمجة تطبيقات المحتوى في Shopping واجهة برمجة تطبيقات التاجر الوصف
غير متاح name:string تمت إضافة حقل جديد للتمييز بين LocalInventory موارد ضمن product. تحدِّد Content API for Shopping المنتجات المتوفرة داخل المتجر من خلال storeCode وproductId.
غير متاح account:string تمت إضافة حقل جديد لتحديد حساب التاجر الذي ينتمي إليه "product" و"LocalInventory".
price: {

object (Price)

}

price: {

object (Price)

}

تم تغيير تعريف Price.
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

تم تغيير تعريف Price.
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

تستخدم "salePriceEffectiveDate" النوع TimePeriod الجديد في واجهة برمجة تطبيقات Merchant Inventories.
quantity:string, quantity:integer تأخذ quantity عددًا صحيحًا بدلاً من سلسلة في واجهة برمجة التطبيقات Merchant Inventories API.
kind:string غير متاح لا يمكن استخدام "kind" في واجهة برمجة تطبيقات Merchant Inventories.
غير متاح localShippingLabel:string تمت إضافة حقل جديد لتصنيف خدمات الشحن المحلية في واجهة برمجة التطبيقات Merchant Inventories API.

المستودع الإقليمي

في ما يلي التغييرات التي تم إجراؤها على المستودع الإقليمي في Merchant Inventories API:

واجهة برمجة تطبيقات المحتوى في Shopping واجهة برمجة تطبيقات التاجر الوصف
غير متاح name:string تمت إضافة حقل جديد للتمييز بين regionalInventory موارد ضمن product. تحدِّد Content API for Shopping المستودع الإقليمي حسب regionId وproductId.
غير متاح account:string تمت إضافة حقل جديد لتحديد حساب التاجر الذي ينتمي إليه "product" و"regionalInventory".
"regionId": string "region": string تُسمّى "regionID" region في واجهة برمجة تطبيقات Merchant Inventories.
price: {

object (Price)

}

price: {

object (Price)

}

تم تغيير تعريف Price.
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

تم تغيير تعريف Price.
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

تستخدم "salePriceEffectiveDate" النوع TimePeriod الجديد في واجهة برمجة تطبيقات Merchant Inventories.
kind:string غير متاح لا يمكن استخدام "kind" في واجهة برمجة تطبيقات Merchant Inventories.