يمكنك استخدام Merchant API لإدارة المستودع المحلي (داخل المتجر) والمستودع الإقليمي.
الطلبات
استخدِم تنسيق عنوان URL للطلب التالي لواجهة برمجة التطبيقات الفرعية Inventories:
POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories
في Merchant API، تتم الإشارة إلى واجهة برمجة التطبيقات الفرعية Inventories ونقطة النهاية ذات الصلة بصيغة الجمع "inventories".
في ما يلي عيّنة مقارنة بين Content API for Shopping وMerchant Inventories API لطلبات المنتجات داخل المتجر:
Content API | Merchant API | |
---|---|---|
عنوان URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories |
المعرفات | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
الطُرق
توفّر واجهة برمجة التطبيقات Merchant API طريقتَين جديدتَين لإدارة المستودع:
- إدراج المستودعات المحلية والإقليمية لمنتجاتك
- إزالة المستودع المحلي والإقليمي من منتجاتك
في ما يلي مقارنة بين طرق المستودعات في Content API for Shopping وMerchant Inventories API:
الطريقة | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
---|---|---|
customBatch |
نعم | لا |
insert |
نعم | نعم |
list |
لا | نعم |
delete |
لا | نعم |
المنتجات المتوفرة داخل المتجر
في ما يلي التغييرات التي تم إجراؤها على المنتجات داخل المتجر في Merchant Inventories API:
واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
---|---|---|
غير متاح | name:string
|
تمت إضافة حقل جديد للتمييز بين موارد LocalInventory ضمن product . تُحدِّد Content API for Shopping المنتجات داخل المتجر باستخدام storeCode وproductId .
|
غير متاح | account:string
|
تمت إضافة حقل جديد لتحديد حساب التاجر الذي ينتمي إليه product وLocalInventory .
|
price: {
|
price: {
|
تم تغيير تعريف Price .
|
salePrice: {
|
salePrice: {
|
تم تغيير تعريف Price .
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
تستخدم salePriceEffectiveDate نوع TimePeriod الجديد في Merchant Inventories API.
|
quantity:string,
|
quantity:integer
|
يقبل quantity عددًا صحيحًا بدلاً من سلسلة في Merchant Inventories API.
|
kind:string
|
غير متاح | kind غير متوافقة مع Merchant Inventories API.
|
غير متاح | localShippingLabel:string
|
تمت إضافة حقل جديد لتصنيف خدمات الشحن داخل المتجر في Merchant Inventories API. |
المستودع الإقليمي
في ما يلي التغييرات التي تم إجراؤها على المستودع الإقليمي في Merchant Inventories API:
واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
---|---|---|
غير متاح | name:string
|
تمت إضافة حقل جديد للتمييز بين موارد regionalInventory ضمن product . تُحدِّد Content API for Shopping المستودع الإعلاني على مستوى منطقة معيّنة باستخدام regionId وproductId .
|
غير متاح | account:string
|
تمت إضافة حقل جديد لتحديد حساب التاجر الذي ينتمي إليه product وregionalInventory .
|
"regionId": string
|
"region": string
|
يُطلَق على regionID اسم region في Merchant Inventories API.
|
price: {
|
price: {
|
تم تغيير تعريف Price .
|
salePrice: {
|
salePrice: {
|
تم تغيير تعريف Price .
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
تستخدم salePriceEffectiveDate نوع TimePeriod الجديد في Merchant Inventories API.
|
kind:string
|
غير متاح | kind غير متوافقة مع Merchant Inventories API.
|