تنظیمات حمل و نقل را از Content API for Shopping منتقل کنید

منبع ShippingSettings به شما امکان می دهد تنظیمات حمل و نقل حساب خود و تمام حساب های فرعی مرتبط با آن را بازیابی و به روز کنید. برای اطلاعات بیشتر در مورد اینکه چگونه می توانید تنظیمات حمل و نقل حساب خود را اضافه یا مدیریت کنید، به نمای کلی تنظیمات حمل و نقل مراجعه کنید.

برای استفاده از 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

برای اطلاعات بیشتر، روش: accounts.shippingSettings.insert را ببینید.

مقایسه بین Content API برای خرید و Merchant API

در اینجا نمونه ای از مقایسه Content API برای خرید با Merchant Shipping Setting API آورده شده است:

Content API Merchant 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}

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

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

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

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

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

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

فیلدهای زیر در Merchant API تغییر نام داده اند:

Content API برای خرید 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
      • Min_scheduling_time_in_days
      • Max_scheduling_time_in_days
      • Scheduling_business_day_config

    • Rate_group
      • single_value_alternative_list

روش ها

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

روش Content API برای خرید Merchant API
customBatch بله خیر
get بله بله
update بله خیر
insert خیر بله
getSupportedCarrier بله خیر
getSupportedHolidays بله خیر
قبلی
مهاجرت مدیریت منابع داده
بعدی
انتقال مدیریت منابع تبدیل