تُعلم طريقة BookingNotification
، المعروفة أيضًا باسم UpdateBooking
Real-Time Update (RTU)، محرّك بحث Google عند إجراء تعديل على الحجز في "مركز الإجراءات" على نظامك.
وتشمل الأمثلة على ذلك الحالات التي تم فيها إلغاء الحجوزات أو تعديلها. في هذه الحالة، يجب إرسال notification.partners.bookings.patch
أو BookingNotification.UpdateBooking
.
متطلبات مهمة BookingNotification
لإكمال هذه المهمة، أرسِل BookingNotifications
صالحًا بدون أخطاء. يمكن أن تؤدي طلبات البيانات من طرق Availability Replace وMerchant وService إلى إبطال المهمة.
الحقول القابلة للتعديل
startTime
duration
partySize
يجب تحديد name
وmerchant_id
وservice_id
وأي حقل محدّد يتغيّر. جميع الحقول الأخرى اختيارية. في بعض الحالات، يمكن تغيير حقول متعددة في الوقت نفسه. في هذه الحالات، تفصل الفواصل بين الحقول في
updateMask
. على سبيل المثال، updateMask=partySize,startTime
.
في حال نجاح المهمة، يحتوي نص الاستجابة على مثال Booking.
مثال على طلب الإلغاء
Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status
Body:
{
"name": "partners/<PARTNER_ID>/bookings/<BOOKING_ID>",
"merchantId": "10001",
"serviceId": "1001",
"status": "CANCELED"
}
نص الاستجابة
مثال على ردّ الإلغاء
booking: {
name: "partners/<PARTNER_ID>/bookings/<BOOKING_ID>",
merchant_id: "10001",
service_id: "1001",
start_time: {
seconds: 1736120700
},
duration: {
seconds: 900
},
status: "CANCELED",
party_size: 2
}