يشير وقت تسليم المنتج إلى الوقت المقدّر لتسليم الطلب بعد تقديمه. يمكن لشركاء إشارات الشحن استخدام هذه الميزة لتحديد أوقات التسليم لمناطق معيّنة نيابةً عن التجّار الذين يتعاونون معهم.
يمكن لشركاء إشارات الشحن استخدام هذا المرجع لضبط مُدد التسليم لأزواج منطقة العرض، وللاطّلاع على مُدد التسليم الحالية أو حذفها نيابةً عن التجّار المرتبطين بهم. يخزّن مرجع واحد ProductDeliveryTime عدة أوقات تسليم، ولا يمكن أن يكون هناك سوى مثيل واحد ProductDeliveryTime لكل عرض.
لاستخدام مورد ProductDeliveryTime، يجب إثبات ملكية حسابك على Merchant Center، وليس حساب التاجر الذي تريد تعديله.
إنشاء
يمكن لشركاء إشارات الشحن إنشاء أو تعديل وقت تسليم المنتج من خلال استدعاء create باستخدام merchantId لحساب التاجر المطلوب تعديله، وProductDeliveryTime. لتعديل وقت تسليم منتج حالي، احرص على تقديم جميع حقول ProductDeliveryTime، بما في ذلك الحقول التي لم تتغيّر. يؤدي كل طلب create إلى الكتابة فوق المثال السابق، وبالتالي يتم فقدان الحقول التي لا تضمّنها. تعرِض هذه الطريقة مثيل ProductDeliveryTime مع المعلومات المعدَّلة التي ترسلها.
يمكن أن يحتوي كل ProductDeliveryTime على 100 إدخال 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