يمكنك استخدام 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}.
في ما يلي نموذج مقارنة لطلبات المستودع المحلّي:
| العنصر | Content API for 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: تتيح لك حذف المستودع المحلّي والإقليمي لمنتجاتك.
في ما يلي مقارنة بين الطرق المتاحة لإدارة المستودعات:
| الطريقة | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
نعم | لا |
insert |
نعم | نعم |
list |
لا | نعم |
delete |
لا | نعم |
الموارد
في ما يلي التغييرات التي تم إجراؤها على المستودعات المحلّية والإقليمية:
| Content API for 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.
|