تنظیمات حمل و نقل را از 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 برای خرید و Merchant API

در اینجا یک مقایسه نمونه از Content API برای خرید با منبع تنظیمات حمل و نقل در API فرعی حساب‌ها آورده شده است:

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}

فهرست زیر به‌روزرسانی‌های اصلی منبع تنظیمات حمل‌ونقل در زیرمجموعه API حساب‌ها را در مقایسه با Content API برای خرید ذکر می‌کند:

  1. کاربران Merchant API باید accounts/ {ACCOUNT_ID} /shippingSettings در قسمت {NAME} قرار دهند تا رفتار مشابهی داشته باشند.
  2. Merchant API از عملیات خواندن و نوشتن در مناطق سفارشی، مانند گروه‌های مکان، پشتیبانی نمی‌کند. مناطق سفارشی مانند گروه های مکان را فقط می توان با استفاده از سرویس منطقه خواند یا نوشت.
  3. یک سرویس در Merchant API از چندین کشور تحویل پشتیبانی می کند.
  4. Merchant API روش فهرستی را برای تنظیمات حمل و نقل ارائه نمی کند، برخلاف روش shippingsettings.list در Content API.

فیلدهای جدید پشتیبانی شده

منبع تنظیمات حمل و نقل در API فرعی حساب‌ها از فیلدهای جدید زیر در مقایسه با Content API برای خرید پشتیبانی می‌کند:

  1. warehouses : اطلاعاتی در مورد یک انبار تکمیلی ارائه می دهد که موجودی را ذخیره و رسیدگی می کند.
  2. برنامه های وفاداری : کاربران Merchant API می توانند اطلاعات برنامه وفاداری را در تنظیمات حمل و نقل خود وارد کنند.
  3. Etag : Etag برای حل مشکلات ناهمگام زمانی طراحی شده است که کاربران مختلف سعی می کنند تنظیمات حمل و نقل را با استفاده از Merchant API و Merchant Center UI به طور همزمان به روز کنند.

فیلدهای تغییر نام یافته

نام فیلدهای زیر در منبع تنظیمات حمل و نقل در API فرعی حساب‌ها تغییر یافته است:

Content API برای خرید منبع تنظیمات حمل و نقل توضیحات
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 حذف می‌شوند. Merchant API هیچ جایگزینی برای این فیلدها ارائه نمی دهد.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

روش ها

در اینجا مقایسه ای از روش های موجود در Content API برای خرید و منبع تنظیمات حمل و نقل آورده شده است:

روش Content API برای خرید Merchant API
customBatch بله خیر
get بله بله
update بله خیر
insert خیر بله
list بله خیر
getSupportedCarrier بله خیر
getSupportedHolidays بله خیر
قبلی
Migrate data sources management
بعدی
Migrate conversion sources management