يمكنك استخدام Merchant API لإدارة المستودع المحلي (داخل المتجر) والمستودع الإقليمي.
الطلبات
استخدِم تنسيق عنوان URL للطلب التالي لواجهة برمجة التطبيقات Merchant Inventories API:
POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories
سيكون {PARENT} بالشكل التالي: accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}.
في ما يلي نموذج مقارنة لطلبات المنتجات داخل المتجر:
المنتج/الخدمة | واجهة برمجة تطبيقات المحتوى في Shopping | 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 طريقتَين جديدتَين لإدارة المستودع:
list
: تتيح لك إدراج المستودع المحلي والإقليمي لمنتجاتك.-
delete
: يتيح لك حذف المستودع المحلي والإقليمي لمنتجاتك.
في ما يلي مقارنة بين الطرق المتاحة لإدارة المستودعات:
الطريقة | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
---|---|---|
customBatch |
نعم | لا |
insert |
نعم | نعم |
list |
لا | نعم |
delete |
لا | نعم |
الموارد
في ما يلي التغييرات التي تم إجراؤها على المستودعات المحلية والإقليمية:
واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
---|---|---|
غير متاح | name:string
|
يُميّز الحقل بين موارد LocalInventory وRegionalInventory ضمن product . تُحدِّد Content API for Shopping المنتجات داخل المتجر باستخدام storeCode وproductId ، والمستودع الإقليمي باستخدام regionId وproductId .
|
غير متاح | account:string
|
يحدِّد الحقل حساب التاجر الذي ينتمي إليه product وLocalInventory وRegionalInventory .
|
price: {
object (Price)
}
|
price: {
|
تم تغيير تعريف Price .
|
salePrice: {
|
salePrice: {
|
تم تغيير تعريف Price .
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
يستخدم salePriceEffectiveDate عنصر TimePeriod الجديد في Merchant Inventories API.
|
kind:string
|
غير متاح | لا تتيح واجهة برمجة التطبيقات kind .
|
quantity:string
|
quantity:integer
|
تأخذ سمة quantity عددًا صحيحًا بدلاً من سلسلة في المنتجات المتوفرة داخل المتجر.
|
غير متاح | localShippingLabel:string
|
يُستخدَم الحقل لتصنيف خدمات الشحن المحلي للمنتجات داخل المتجر. |
"regionId": string
|
"region": string
|
تم تغيير اسم regionID ليصبح region في المستودع الإقليمي.
|