تشير رسالة الأشكال البيانية
ShippingSettings
يتيح لك استرداد إعدادات الشحن في حسابك وتعديلها
كل الحسابات الفرعية المرتبطة به لمزيد من المعلومات حول كيفية
إضافة إعدادات الشحن في حسابك أو إدارتها. راجِع القسم نظرة عامة حول الشحن.
الإعدادات.
لاستخدام 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
لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة:
accounts.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} |
تشير القائمة التالية إلى التعديلات الرئيسية في Merchant Shipping settings API. مقارنةً بـ 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 في بلدان تسليم متعددة.
الحقول الجديدة المتوافقة
تتوافق واجهة برمجة تطبيقات إعدادات شحن التاجر مع الحقول الجديدة التالية مقارنةً واجهة برمجة تطبيقات المحتوى في 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
لاسترداد
تعديل إعدادات الشحن لعدة حسابات في طلب واحد.
حقول متوقّفة نهائيًا
تم إيقاف الحقول التالية من Content API في Merchant API. التاجر لا توفّر واجهة برمجة التطبيقات أي بديل لهذه الحقول.
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Min_scheduling_time_in_days
Max_scheduling_time_in_days
Scheduling_business_day_config
Rate_group
single_value_alternative_list
الطُرق
في ما يلي مقارنة بين الطرق في Content API for Shopping واجهة برمجة تطبيقات إعدادات شحن التجّار:
الطريقة | واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر |
---|---|---|
customBatch |
نعم | لا |
get |
نعم | نعم |
update |
نعم | لا |
insert |
لا | نعم |
getSupportedCarrier |
نعم | لا |
getSupportedHolidays |
نعم | لا |