نقل إعدادات الشحن من 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}

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

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

يتيح مرجع إعدادات الشحن في واجهة برمجة التطبيقات الفرعية "الحسابات" الحقول الجديدة التالية مقارنةً بواجهة 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 نعم لا
السابق
Migrate region management
التالي
Migrate online return policy management