BookingNotification Ready
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
BookingNotification
メソッド(UpdateBooking
リアルタイム更新(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
}
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 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 }"]]