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