يمكنك استخدام Merchant API لإدارة المنتجات المتوفرة داخل المتجر (في المتجر) ومنطقتك.
الكائن Requests
استخدِم التنسيق التالي لعنوان URL للطلب في واجهة برمجة التطبيقات الفرعية للمستودعات:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
في Merchant API، يُشار إلى واجهة برمجة التطبيقات الفرعية للمستودعات ونقطة النهاية ذات الصلة بصيغة الجمع "المستودعات".
في ما يلي نموذج للمقارنة بين Content API for Shopping وMerchant Inventories API لطلبات المنتجات المتوفرة داخل المتجر:
Content API | واجهة برمجة تطبيقات التاجر | |
---|---|---|
عنوان URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories |
المعرّفات | {merchantId}/products/{productId} |
{name}
|
الطُرق
تقدّم Merchant API طريقتين جديدتين لإدارة المستودع، وهما:
- إدراج المنتجات المتوفرة محليًا وإقليميًا لمنتجاتك
- إزالة المستودع المحلي والإقليمي من منتجاتك
في ما يلي مقارنة بين طرق المستودع الإعلاني في Content API for Shopping وMerchant Inventories API:
الطريقة | واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر |
---|---|---|
customBatch |
نعم | لا |
insert |
نعم | نعم |
list |
لا | نعم |
delete |
لا | نعم |
المنتجات المتوفرة داخل المتجر
في ما يلي التغييرات التي طرأت على المنتجات المتوفرة داخل المتجر في Merchant Inventories API:
واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر | الوصف |
---|---|---|
غير متاح | 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:
واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر | الوصف |
---|---|---|
غير متاح | 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.
|