يشير وقت تسليم المنتج إلى الوقت المقدّر لتسليم الطلب بعد تقديمه. يمكن لشركاء إشارات الشحن استخدام هذه الميزة لتحديد أوقات التسليم لمناطق معيّنة نيابةً عن التجّار الذين يتعاونون معهم.
يمكن لشركاء إشارات الشحن استخدام هذا المرجع لضبط مُدد التسليم لأزواج منطقة العرض، وللاطّلاع على مُدد التسليم الحالية أو حذفها نيابةً عن التجّار المرتبطين بهم. يخزّن مرجع واحد 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