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

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}

تتضمّن القائمة التالية التعديلات الرئيسية في مرجع إعدادات الشحن في واجهة برمجة التطبيقات الفرعية Accounts مقارنةً بـ 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.

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

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

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

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

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

Content API for 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 ومرجع إعدادات الشحن:

الطريقة Content API for Shopping Merchant API
customBatch نعم لا
get نعم نعم
update نعم لا
insert لا نعم
list نعم لا
getSupportedCarrier نعم لا
getSupportedHolidays نعم لا
السابق
Migrate data sources management
التالي
Migrate conversion sources management