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

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

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