BookingNotification Ready

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
}