منبع ShippingSettings به شما امکان میدهد تنظیمات حمل و نقل حساب خود و تمام حسابهای فرعی مرتبط با آن را بازیابی و بهروزرسانی کنید. برای اطلاعات بیشتر در مورد نحوه اضافه کردن یا مدیریت تنظیمات حمل و نقل حساب خود، به «مروری بر تنظیمات حمل و نقل» مراجعه کنید.
برای استفاده از رابط برنامهنویسی کاربردی فروشنده (Merchant API) جهت خواندن اطلاعات تنظیمات ارسال، از درخواستهای زیر استفاده کنید:
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings
به جای {ACCOUNT_ID} ، شناسه منحصر به فرد حساب مرکز فروش خود را وارد کنید.
برای استفاده از رابط برنامهنویسی کاربردی فروشنده (Merchant API) جهت بهروزرسانی اطلاعات تنظیمات ارسال، از درخواستهای زیر استفاده کنید:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
برای اطلاعات بیشتر، به Method: accounts.shippingSettings.insert مراجعه کنید.
مقایسه بین API محتوا برای خرید و API فروشنده
در اینجا یک مقایسه نمونه از API محتوا برای خرید با منبع تنظیمات ارسال در زیر API حسابها آورده شده است:
| رابط برنامهنویسی کاربردی محتوا | رابط برنامهنویسی کاربردی (API) فروشنده | |
|---|---|---|
| آدرس اینترنتی | 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 حسابها در مقایسه با API محتوا برای خرید اشاره میکند:
- کاربران رابط برنامهنویسی کاربردی فروشگاه (Merchant API) برای داشتن رفتار مشابه باید
accounts/ {ACCOUNT_ID} /shippingSettingsدر فیلد {NAME} قرار دهند. - رابط برنامهنویسی کاربردی فروشنده از عملیات خواندن و نوشتن در ناحیههای سفارشی، مانند گروههای مکانی، پشتیبانی نمیکند. ناحیههای سفارشی مانند گروههای مکانی فقط با استفاده از سرویس منطقه قابل خواندن یا نوشتن هستند.
- یک سرویس در Merchant API از چندین کشور تحویل پشتیبانی میکند.
- برخلاف متد shippingsettings.list در Content API، رابط برنامهنویسی کاربردی فروشنده (Merchant API) متدی به نام list برای تنظیمات حمل و نقل ارائه نمیدهد.
فیلدهای پشتیبانی شده جدید
منبع تنظیمات ارسال در زیر-API حسابها، در مقایسه با API محتوا برای خرید، از فیلدهای جدید زیر پشتیبانی میکند:
-
warehouses: اطلاعاتی در مورد انبار تکمیل سفارش ارائه میدهد که موجودی را ذخیره و مدیریت میکند. - برنامههای وفاداری : کاربران API فروشگاه میتوانند اطلاعات برنامه وفاداری را در تنظیمات ارسال خود وارد کنند.
- Etag : Etag برای حل مشکلات ناهمزمان طراحی شده است، زمانی که کاربران مختلف سعی میکنند تنظیمات حمل و نقل را با استفاده از Merchant API و Merchant Center UI به طور همزمان بهروزرسانی کنند.
فیلدهای تغییر نام داده شده
فیلدهای زیر در تنظیمات ارسال در زیر API حسابها تغییر نام داده شدهاند:
| API محتوا برای خرید | منبع تنظیمات حمل و نقل | توضیحات |
|---|---|---|
service | services | یک سرویس حمل و نقل واحد. |
service.name | services.serviceName | نام آزاد سرویس که باید در حساب مرکز فروشندگان شما منحصر به فرد باشد. |
service.deliveryCountry | services.deliveryCountries | کد منطقه CLDR کشوری که خدمات حمل و نقل در آن اعمال میشود. |
service.currency | services.currencyCode | کد CLDR ارزی که این سرویس برای آن اعمال میشود. |
service.deliveryTime.minTransitTimeInDays | services.deliveryTime.minTransitDays | حداقل تعداد روزهای کاری که یک سفارش در حال ارسال است. به عنوان مثال، عدد ۰ به معنی تحویل در همان روز و عدد ۱ به معنی تحویل در روز بعد است. |
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 برای بازیابی و بهروزرسانی تنظیمات حملونقل چندین حساب کاربری در یک درخواست واحد استفاده کنید.
فیلدهای حذف شده
فیلدهای زیر از API محتوا برای خرید، در API فروشگاه حذف شدهاند. API فروشگاه هیچ جایگزینی برای این فیلدها ارائه نمیدهد.
-
postal_code_group -
service -
Pickup_service -
Eligibility -
Scheduling_channel -
Delivery_time -
Holiday_cutoff -
Rate_group-
single_value_alternative_list
-
روشها
در اینجا مقایسهای از متدهای موجود در API محتوا برای خرید و منبع تنظیمات ارسال ارائه شده است:
| روش | API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده |
|---|---|---|
customBatch | بله | خیر |
get | بله | بله |
update | بله | خیر |
insert | خیر | بله |
list | بله | خیر |
getSupportedCarrier | بله | خیر |
getSupportedHolidays | بله | خیر |