BookingNotification Ready
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
BookingNotification
(còn gọi là UpdateBooking
Real-Time Update – RTU) sẽ thông báo cho Google khi bạn cập nhật thông tin đặt lịch hẹn trên Actions Center trong hệ thống của mình.
Ví dụ: trường hợp đặt phòng bị huỷ hoặc sửa đổi. Đó là khi bạn phải gửi notification.partners.bookings.patch
hoặc BookingNotification.UpdateBooking
.
Yêu cầu đối với tác vụ BookingNotification
Để hoàn tất việc này, hãy gửi BookingNotifications
hợp lệ mà không có lỗi. Các lệnh gọi đến phương thức Thay thế phạm vi cung cấp, Người bán và Dịch vụ có thể làm mất hiệu lực nhiệm vụ.
Các trường có thể sửa đổi
startTime
duration
partySize
Bạn phải chỉ định name
, merchant_id
, service_id
và mọi trường cụ thể có thay đổi. Tất cả các trường khác đều không bắt buộc. Trong một số trường hợp, nhiều trường có thể thay đổi cùng một lúc. Trong những trường hợp như vậy, dấu phẩy sẽ phân tách các trường trong updateMask
. Ví dụ: updateMask=partySize,startTime
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Booking.
Ví dụ về yêu cầu huỷ
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"
}
Nội dung phản hồi
Ví dụ về phản hồi huỷ
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
}
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[],[],null,["# BookingNotification Ready\n\n`BookingNotification` method, also known as the `UpdateBooking` Real-Time Update (RTU), notifies\nGoogle when an update is made to the Actions Center booking on your system.\nExample situations include canceled or modified reservations. That is when a\n[`notification.partners.bookings.patch`](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings/patch) or `BookingNotification.UpdateBooking` must be sent.\n\nBookingNotification task requirements\n-------------------------------------\n\nTo complete this task, send valid `BookingNotifications` with no errors. Calls\nto Availability Replace, Merchant, and Service methods can invalidate the task.\n\n### Modifiable fields\n\n- `startTime`\n- `duration`\n- `partySize`\n\nThe `name`, `merchant_id`, `service_id`, and any specific field that changes\nmust be specified. All other fields are optional. In some cases, multiple fields\ncan change at the same time. In such cases, commas separate the fields in the\n`updateMask`. For example, `updateMask=partySize,startTime`.\n\nIf the task is successful, the response body contains an instance of [Booking](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#Booking).\n\nCancelation request example\n---------------------------\n\n Request:\n PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/\u003cPARTNER_ID\u003e/bookings/\u003cBOOKING_ID\u003e?updateMask=status\n\n Body:\n {\n \"name\": \"partners/\u003cPARTNER_ID\u003e/bookings/\u003cBOOKING_ID\u003e\",\n \"merchantId\": \"10001\",\n \"serviceId\": \"1001\",\n \"status\": \"CANCELED\"\n }\n\n### Response body\n\n#### Cancelation response example\n\n booking: {\n name: \"partners/\u003cPARTNER_ID\u003e/bookings/\u003cBOOKING_ID\u003e\",\n merchant_id: \"10001\",\n service_id: \"1001\",\n start_time: {\n seconds: 1736120700\n },\n duration: {\n seconds: 900\n },\n status: \"CANCELED\",\n party_size: 2\n }"]]