انتقال تنظیمات ارسال کالا از «میانای برنامه‌سازی کاربردی محتوا برای خرید»

منبع 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 ویژه Shopping با منبع تنظیمات «ارسال» در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» آورده شده است:

	میانای برنامه‌سازی کاربردی محتوا	میانای برنامه‌سازی کاربردی فروشنده
نشانی وب	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، روش فهرست برای تنظیمات ارسال ارائه نمی‌دهد.

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

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

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

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

نام فیلدهای زیر در منبع تنظیمات «ارسال» در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» تغییر کرده است:

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	میانای برنامه‌سازی کاربردی فروشنده
customBatch	بله	نه
get	بله	بله
update	بله	نه
insert	نه	بله
list	بله	نه
getSupportedCarrier	بله	نه
getSupportedHolidays	بله	نه