يمكنك استخدام Merchant API لإدارة المستودع المحلي (داخل المتجر) والإقليمي.
الطلبات
استخدِم تنسيق عنوان URL التالي للطلب في Merchant Inventories API:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{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/v1/{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
    | 
   تمت إضافة حقل جديد لتحديد حساب Merchant Center الذي تنتمي إليه السمتان product وLocalInventory.
    | 
  
   
       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
    | 
   تمّت إضافة حقل جديد لتحديد حساب Merchant Center الذي ينتمي إليه product وregionalInventory.
    | 
  
"regionId": string
    | 
   "region": string
    | 
   تم تغيير اسم regionID إلى region في المستودع الإقليمي.
    | 
  
حقول من النوع string تتضمّن مجموعة محدّدة من القيم
    | 
   حقول من النوع enum تتضمّن مجموعة محدّدة من القيم
    | 
   أصبحت الحقول ضمن سمات المستودع التي تتضمّن مجموعة محدّدة من القيم (مثل availability وpickupMethod) من النوع enum.
    |