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

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

الكائن Requests

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

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

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

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

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

في ما يلي التغييرات التي طرأت على المستودع الخاص بمنطقة معيّنة في 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 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.