يمكنك استخدام 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: {
|
price: {
|
تم تغيير تعريف Price .
|
salePrice: {
|
salePrice: {
|
تم تغيير تعريف Price .
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
تستخدم "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: {
|
price: {
|
تم تغيير تعريف Price .
|
salePrice: {
|
salePrice: {
|
تم تغيير تعريف Price .
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
تستخدم "salePriceEffectiveDate " النوع TimePeriod الجديد في واجهة برمجة تطبيقات Merchant Inventories.
|
kind:string
|
غير متاح | لا يمكن استخدام "kind " في واجهة برمجة تطبيقات Merchant Inventories.
|