نقل إعدادات الشحن من 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 والتاجر واجهة برمجة تطبيقات إعدادات الشحن:

	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:

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 في بلدان تسليم متعددة.

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

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

1. المستودعات: يتم توفير معلومات عن مستودع لتوصيل الطلبات، التي تخزّن وتعالج المخزون.
2. برامج الولاء: يمكن لمستخدمي Merchant API إدخال معلومات برنامج الولاء في إعدادات الشحن الخاصة بها.
3. 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	نعم	لا