لاستخدام Merchant API لقراءة معلومات إعدادات الشحن، اتّبِع الطلبات التالية:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
استبدِل {accountId} بالمعرّف الفريد لحسابك على Merchant Center.
لاستخدام Merchant API لقراءة معلومات إعدادات الشحن، اتّبِع الطلبات التالية:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
مقارنة بين Content API for Shopping وMerchant API
وفي ما يلي نموذج للمقارنة بين Content API for Shopping وواجهة برمجة تطبيقات إعدادات الشحن للتاجر:
Content API | واجهة برمجة تطبيقات التاجر | |
---|---|---|
عنوان URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
المعرّفات | {accountId}/shippingsettings/ {accountId} |
{name} |
تشير القائمة التالية إلى التعديلات الرئيسية في واجهة برمجة تطبيقات إعدادات شحن التجّار مقارنةً بـ Content API for Shopping:
- وعلى مستخدمي Merchant API وضع
accounts/{accountId}/shippingSettings
في حقل {name} للحصول على السلوك نفسه. - لا تتيح Merchant API عمليات القراءة والكتابة في المناطق المخصّصة، مثل مجموعات المواقع الجغرافية. لا يمكن قراءة المناطق المخصّصة مثل مجموعات المواقع الجغرافية أو كتابتها إلا باستخدام خدمة المنطقة.
- تختلف طريقة إعداد
WarehouseBasedDeliveryTime
في Merchant API عن طريقة Content API for Shopping. إذا كنت تستخدم Merchant API، عليك تحديد معلومات المستودع ضمنshippingsettings.warehouses
. ويمكن لكل خدمة شحن الإشارة إلى المستودع من خلال اسم المستودع ضمنwarehouseBaseDeliveryTime
. - تتيح خدمة واحدة في Merchant API عدة بلدان للتسليم.
الحقول الجديدة المتاحة
تتيح Merchant Shipping Settings API استخدام الحقول الجديدة التالية مقارنةً بواجهة Content API for Shopping:
- مستودعات التخزين: تقدِّم معلومات عن مستودع توصيل الطلبات، والذي يخزِّن المخزون ويعالجه.
- برامج الولاء: يمكن لمستخدمي Merchant API إدخال معلومات برنامج الولاء في إعدادات الشحن الخاصة بهم.
- علامة Etag: تهدف علامة Etag إلى حلّ المشاكل المتعلّقة بعدم المزامنة عندما يحاول مستخدمون مختلفون تعديل إعدادات الشحن باستخدام Merchant API وواجهة مستخدم Merchant Center في الوقت نفسه.
الحقول التي تمت إعادة تسميتها
تمت إعادة تسمية الحقول التالية في Merchant API:
واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات إعدادات شحن التجّار | الوصف |
---|---|---|
service |
services |
خدمة شحن واحدة. |
service.name |
services.serviceName |
اسم بتصميم مرن للخدمة يجب أن يكون فريدًا ضمن حسابك على Merchant Center. |
service.deliveryCountry |
services.deliveryCountries |
تمثّل هذه السمة رمز CLDR الإقليمي للبلد الذي تنطبق عليه خدمة الشحن. |
service.currency |
services.currencyCode |
تمثّل هذه السمة رمز CLDR للعملة التي تنطبق عليها هذه الخدمة. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
الحدّ الأدنى لعدد أيام العمل التي يستغرقها الطلب في عملية النقل. على سبيل المثال، يشير الرقم 0 إلى التسليم في اليوم نفسه، ويشير 1 إلى التسليم في اليوم التالي. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
الحدّ الأقصى لعدد أيام العمل التي يستغرقها الطلب في عملية النقل. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
الحد الأدنى لعدد أيام العمل التي يتم قضاؤها قبل شحن طلب |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
الحد الأقصى لعدد أيام العمل التي يتم قضاؤها قبل شحن طلب |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
معرّف المنطقة الزمنية لموعد الموعد النهائي لطلب المنتجات |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
اسم مجموعة الرموز البريدية. |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
تمثّل هذه السمة تصنيف مدة النقل للمنتج. |
service.rate_group |
services.rateGroups |
تعريفات مجموعات تعرفات الشحن |
service.rate_group.subtable |
services.rateGroups.subtables |
قائمة بالجداول الفرعية. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
قائمة بأسعار شركة النقل. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
قائمة بمجموعات رموز المتجر التي تشترك في الحد الأدنى لقيمة طلب الشراء نفسه |
الطرق التي تم إيقافها نهائيًا
لا يمكنك استخدام shippingsettings.custombatch
لاسترداد إعدادات
الشحن وتعديلها لحسابات متعددة في طلب واحد.
حقول تم إيقافها نهائيًا
تم إيقاف الحقول التالية نهائيًا في Merchant API. يُرجى العلم أنّ Merchant API لا توفّر أي بديل لهذه الحقول.
واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| الطُرقوفي ما يلي مقارنة بين الطرق في Content API for Shopping وواجهة برمجة تطبيقات إعدادات شحن التجّار:
|