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

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

الطلبات

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

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

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

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

Content API Merchant API
عنوان URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories
المعرفات {MERCHANT_ID}/products/{PRODUCT_ID} {NAME}

الطُرق

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

  • إدراج المستودعات المحلية والإقليمية لمنتجاتك
  • إزالة المستودع المحلي والإقليمي من منتجاتك

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

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

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

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

واجهة برمجة تطبيقات المحتوى في Shopping Merchant API الوصف
غير متاح 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 API.
quantity:string, quantity:integer يقبل quantity عددًا صحيحًا بدلاً من سلسلة في Merchant Inventories API.
kind:string غير متاح kind غير متوافقة مع Merchant Inventories API.
غير متاح localShippingLabel:string تمت إضافة حقل جديد لتصنيف خدمات الشحن داخل المتجر في Merchant Inventories API.

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

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

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

object (Price)

}

price: {

object (Price)

}

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

object (Price)

}

salePrice: {

object (Price)

}

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

object (TimePeriod)

},

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