زمان تحویل محصول، تخمینی از مدت زمان لازم برای تحویل سفارش پس از ثبت آن است. شرکای سیگنالهای ارسال میتوانند از این ویژگی برای تعیین زمان تحویل برای مناطق خاص به نمایندگی از فروشندگانی که با آنها همکاری میکنند، استفاده کنند.
شرکای سیگنالهای ارسال میتوانند از این منبع برای تنظیم زمان تحویل برای جفتهای پیشنهاد-منطقه و مشاهده یا حذف زمانهای تحویل موجود از طرف فروشندگانی که به آنها مرتبط هستند، استفاده کنند. یک منبع ProductDeliveryTime چندین زمان تحویل را ذخیره میکند و برای هر پیشنهاد فقط میتواند یک نمونه ProductDeliveryTime وجود داشته باشد.
برای استفاده از منبع ProductDeliveryTime ، به عنوان حساب مرکز فروشندگان خود، و نه حساب فروشگاهی که در حال بهروزرسانی آن هستید، احراز هویت کنید.
ایجاد کردن
شرکای سیگنالهای حمل و نقل میتوانند با فراخوانی تابع create به همراه merchantId حساب تجاری برای بهروزرسانی و یک نمونه از ProductDeliveryTime ، زمان تحویل محصول را ایجاد یا بهروزرسانی کنند. برای بهروزرسانی زمان تحویل محصول موجود، مطمئن شوید که تمام فیلدهای ProductDeliveryTime ، از جمله آنهایی که تغییر نکردهاند، را ارائه میدهید. هر درخواست create نمونه قبلی را بازنویسی میکند، بنابراین فیلدهایی که وارد نمیکنید از دست میروند. این متد، نمونه ProductDeliveryTime را با اطلاعات بهروزرسانیشدهای که ارسال میکنید، برمیگرداند.
هر ProductDeliveryTime میتواند حداکثر ۱۰۰ ورودی areaDeliveryTimes داشته باشد.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime
در اینجا یک نمونه بدنه درخواست آمده است:
{
"productId": {
"productId": "online:en:US:offer-id"
}
"areaDeliveryTimes": [
{
"deliveryArea": {
"countryCode": "US"
"postalCodeRange": {
"firstPostalCode": "123*"
"lastPostalCode": "456*"
}
}
"deliveryTime": {
"minHandlingTimeDays": "0"
"maxHandlingTimeDays": "1"
"minTransitTimeDays": "2"
"maxTransitTimeDays": "4"
}
},
{
"deliveryArea": {
"countryCode": "US"
"administrativeAreaCode": "NY"
}
"deliveryTime": {
"minHandlingTimeDays": "0"
"maxHandlingTimeDays": "1"
"minTransitTimeDays": "5"
"maxTransitTimeDays": "7"
}
}
]
}
دریافت
با فراخوانی تابع get به همراه merchantId فروشنده و productId زمان تحویل یک محصول را دریافت کنید. این متد نمونهای از ProductDeliveryTime را برای productId داده شده برمیگرداند.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId
حذف
شرکای سیگنالهای حمل و نقل میتوانند با فراخوانی تابع delete به همراه merchantId و productId فروشنده، زمان تحویل محصول را حذف کنند. این متد یک پاسخ خالی برمیگرداند.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId