نقل إعدادات الشحن من Content API for Shopping

يتيح لك المرجع 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 وواجهة برمجة التطبيقات Merchant Shipping settings API:

	Content API	Merchant 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:

1. على مستخدمي Merchant API إدخال accounts/{accountId}/shippingSettings في الحقل {name} للحصول على السلوك نفسه.
2. لا تتيح Merchant API عمليات القراءة والكتابة في المناطق المخصّصة، مثل مجموعات المواقع الجغرافية. لا يمكن قراءة المناطق المخصّصة، مثل مجموعات المواقع الجغرافية، أو كتابتها إلا باستخدام خدمة المنطقة.
3. تختلف طريقة إعداد WarehouseBasedDeliveryTime لـ Merchant API عن طريقة إعداد Content API for Shopping. إذا كنت تستخدم Merchant API، عليك تحديد معلومات المستودع ضمن shippingsettings.warehouses. بعد ذلك، يمكن لكل خدمة شحن الإشارة إلى المستودع من خلال اسم المستودع ضمن warehouseBaseDeliveryTime.
4. تتيح خدمة واحدة في Merchant API بلدان تسليم متعدّدة.

الحقول الجديدة المتوافقة

توفّر واجهة برمجة التطبيقات Merchant Shipping settings API الحقول الجديدة التالية مقارنةً بواجهة Content API for Shopping:

1. المستودعات: تقدّم معلومات عن مستودع المعالجة الذي يتم فيه تخزين المخزون والتعامل معه.
2. برامج الولاء: يمكن لمستخدمي Merchant API إدخال معلومات برنامج الولاء في إعدادات الشحن.
3. علامة Etag: تم تصميم علامة Etag لحلّ المشاكل غير المتزامنة عندما يحاول مستخدمون مختلفون تعديل إعدادات الشحن باستخدام Merchant API وواجهة مستخدم Merchant Center في الوقت نفسه.

الحقول التي تمّ تغيير أسمائها

تم تغيير أسماء الحقول التالية في Merchant API:

واجهة برمجة تطبيقات المحتوى في Shopping	Merchant Shipping settings API	الوصف
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. لا توفّر 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 و Merchant Shipping settings API:

الطريقة	واجهة برمجة تطبيقات المحتوى في Shopping	Merchant API
customBatch	نعم	لا
get	نعم	نعم
update	نعم	لا
insert	لا	نعم
getSupportedCarrier	نعم	لا
getSupportedHolidays	نعم	لا