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

يتيح لك المورد ShippingSettings استرداد إعدادات الشحن في حسابك وتعديلها، بالإضافة إلى جميع الحسابات الفرعية المرتبطة به. لمزيد من المعلومات حول كيفية إضافة إعدادات الشحن في حسابك أو إدارتها، يُرجى الاطّلاع على نظرة عامة على إعدادات الشحن.

لاستخدام Merchant API لقراءة معلومات إعدادات الشحن، استخدِم الطلبات التالية:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

استبدِل {ACCOUNT_ID} بالمعرّف الفريد لحسابك على Merchant Center.

لاستخدام Merchant API من أجل تعديل معلومات إعدادات الشحن، استخدِم الطلبات التالية:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.shippingSettings.insert.

مقارنة بين Content API for Shopping وMerchant API

في ما يلي نموذج مقارنة بين Content API for Shopping ومرجع إعدادات الشحن في واجهة برمجة التطبيقات الفرعية للحسابات:

	Content API	Merchant API
عنوان URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
المعرّفات	{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

تتضمّن القائمة التالية التعديلات الرئيسية في مرجع إعدادات الشحن في واجهة برمجة التطبيقات الفرعية "الحسابات" مقارنةً بـ Content API for Shopping:

1. على مستخدمي Merchant API إدخال accounts/{ACCOUNT_ID}/shippingSettings في الحقل {NAME} للحصول على السلوك نفسه.
2. لا تتيح Merchant API عمليات القراءة والكتابة في المناطق المخصّصة، مثل مجموعات المواقع الجغرافية. لا يمكن قراءة المناطق المخصّصة، مثل مجموعات المواقع الجغرافية، أو كتابتها إلا باستخدام خدمة المنطقة.
3. تتيح خدمة واحدة في Merchant API إمكانية التسليم إلى بلدان متعددة.
4. لا توفّر Merchant API طريقة قائمة لإعدادات الشحن، على عكس طريقة shippingsettings.list في Content API.

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

يتيح مرجع إعدادات الشحن في واجهة برمجة التطبيقات الفرعية للحسابات استخدام الحقول الجديدة التالية مقارنةً بـ Content API for Shopping:

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

الحقول التي تمت إعادة تسميتها

تمت إعادة تسمية الحقول التالية في مورد إعدادات الشحن في واجهة برمجة التطبيقات الفرعية للحسابات:

واجهة برمجة تطبيقات المحتوى في 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 for Shopping في Merchant API. لا توفّر Merchant API أي بديل لهذه الحقول.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

الطُرق

في ما يلي مقارنة بين الطرق في Content API for Shopping ومرجع إعدادات الشحن:

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