يمكنك استخدام 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 .
|