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