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

لاستخدام 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:

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	واجهة برمجة تطبيقات إعدادات شحن التجّار	الوصف
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 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 |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 نعم لا الحصول على نعم نعم تحديث نعم لا insert لا نعم getSupportedCarrier نعم لا getSupportedHolidays نعم لا