リアルタイム アップデートのユースケース
リアルタイム更新は、次のシナリオで常に発行する必要があります。
- ユーザーがシステムで予約をキャンセルし、予約枠が利用可能になった場合。
- ユーザーがアクション センターを通じて予約し、予約枠が利用できなくなった場合。
- アクション センター経由で行った予約が、販売者によって直接キャンセルされた。元の予約枠が再び利用可能になったため、予約と空き情報を更新する必要があります。
また、空き情報置換 RTU を実装する場合、次のシナリオでリアルタイム更新を発行する必要があります。
- 販売者がシステムでスケジュール（空き情報）を変更したとき。
- ユーザーがシステムで予約を行い、予約枠が利用できなくなった場合。
-
CheckAvailabilityとの従来型の統合を使用している場合、予約サーバーのCheckAvailability呼び出しが、実際の空き情報と一致しない空き情報を返した。
Maps Booking API のすべての呼び出しが必要なわけではありません。次の項目は必須です。
-
notification.partners.bookings.patch（BookingNotification.UpdateBooking）
統合の種類によっては、次のものも利用可能または必須になることがあります。
inventory.partners.availability.replace（InventoryUpdate.BatchServiceAvailability） またはinventory.partners.merchants.services.availability.replace（InventoryUpdate.ReplaceServiceAvailability）
Update Booking RTU
システムでアクション センターの予約が更新された場合（キャンセルまたは変更など）、notification.partners.bookings.patch（BookingNotification.UpdateBooking）を送信する必要があります。
変更可能なフィールド
statusstartTimedurationpartySizepaymentInformation.prepaymentStatus
解約の例
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", "startTime": "2025-01-02T15:01:23.045123456Z", "duration": "3000s", "status": "CANCELED" }
空き情報置換 RTU
在庫状況を更新するには、次の 2 種類の置換メソッドを使用できます。
-
一括置換（
InventoryUpdate.BatchServiceAvailability）: 複数の販売者とサービスの空き情報を完全に置き換えます。- 注: このバッチ呼び出しでは、原子性は保証されません。正常に更新された予約枠のみが返されます。
-
単一置換（
InventoryUpdate.ReplaceServiceAvailability）: 1 つの販売者とサービスの空き情報を完全に置き換えます。
詳細については、次のリファレンスをご覧ください。
リアルタイム更新では、フィードで送信されるデータと同じ空き状況の構造を使用する必要があります。次のいずれかを使用する必要があります。
spotsOpenrecurrence
呼び出す置換メソッドを選択する
次のガイドを参考に、どちらの置換方法がより適しているかを判断してください。
- 複数の販売者に影響が出ていますか？たとえば、1 つのリクエストで複数の販売者の在庫状況を置き換えます。
- システムは、前回更新以降のすべての在庫状況の変更を送信することで、Google と定期的に同期します（推奨されません）。
- 一括置換
- 注: 在庫 RTU は、お客様側で更新が発生してから 5 分以内に送信されることが想定されています。そのため、少なくとも 5 分ごとに更新を確認して送信する必要があります。
- いずれにも当てはまらない場合、または 1 つの販売者とサービスのみを更新する必要がある場合
- Single Replace
- 注: 複数の単一置換呼び出しを使用してバッチ置換呼び出しをエミュレートできますが、単一のバッチ置換呼び出しを使用する方が効率的です。
リアルタイム アップデート: スポット オープン形式
フィード、予約サーバー、リアルタイム更新で同じ形式を使用することが重要です。
spots_open フィード スニペットは次のようになります。
フィード スニペット
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 2,
"spots_total": 2,
"start_sec": 1735831800, # January 02, 2025 15:30:00
"duration_sec": 1800,
"availabilityTag": "1000001"
}
]在庫更新 API の場合、午後 3 時 30 分のスロットが予約されたときの置換リクエスト本文の形式は次のようになります。
リアルタイム アップデート スニペットを置き換える
{
"extendedServiceAvailability": [
{
"merchantId": "1001",
"serviceId": "12310",
"startTimeRestrict": "2025-01-02T15:01:23.045123456Z",
"endTimeRestrict": "2025-01-02T19:01:23.045123456Z",
"availability": [
{
"startTime": "2025-01-02T15:30:00.00Z",
"duration": "3600s",
"spotsOpen": "1",
"spotsTotal": "2",
"availabilityTag": "1000001"
}
]
}
]
}午後 3 時 30 分に新しいスロットが予約された場合、次の日次フィードで想定される内容は次のようになります。
フィード スニペット
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 1,
"spots_total": 2,
"start_sec": 1735831800, # January 02, 2025 15:30:00
"duration_sec": 1800,
"availabilityTag": "1000001"
}
]リアルタイム アップデート: 繰り返し形式
フィード、予約サーバー、リアルタイム更新で同じ形式を使用することが重要です。
繰り返しを使用するフィードは次のようになります。
フィード スニペット
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 1,
"spots_total": 1,
"start_sec": 1540890000, # October 30, 2018 9:00:00 AM
"duration_sec": 1800,
"recurrence": {
"repeat_every_sec": 1800,
"repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM
},
"schedule_exception": [
{
"time_range": {
"begin_sec": 1540902600, # October 30, 2018 12:30:00 PM
"end_sec": 1540904400 # October 30, 2018 1:00:00 PM
}
}
],
}
]Inventory Update API の場合、3 時 30 分のスロットが予約されたときの置換リクエストの本文の形式は次のようになります。
{
"extendedServiceAvailability": [
{
"merchantId": "1001",
"serviceId": "12310",
"startTimeRestrict": "2018-10-30T15:01:23.045123456Z",
"endTimeRestrict": "2018-10-30T19:01:23.045123456Z",
"availability": [
{
"startTime": "2018-10-30T15:30:00.00Z",
"duration": "3600s",
"spotsOpen": "1",
"scheduleException": [
{
"timeRange": {
"startTime": "2018-10-30T12:30:00.00Z",
"endTime": "2018-10-30T13:00:00.00Z"
}
},
{
"timeRange": {
"startTime": "2018-10-30T15:30:00.00Z",
"endTime": "2018-10-30T16:00:00.00Z"
}
}
]
}
]
}
]
}次の日次フィードで想定される内容の例を次に示します。これは、その販売者のサービス全体の空き状況であり、以前の schedule_exceptions と新しい schedule_exceptions のすべてです。
フィード スニペット
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 1,
"spots_total": 1,
"start_sec": 1540890000, # October 30, 2018 9:00:00 AM
"duration_sec": 1800,
"recurrence": {
"repeat_every_sec": 1800,
"repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM
},
"schedule_exception": [
{
"time_range": {
"begin_sec": 1540902600, # October 30, 2018 12:30:00 PM
"end_sec": 1540904400 # October 30, 2018 1:00:00 PM
}
},
{
"time_range": {
"begin_sec": 1540913400, # October 30, 2018 3:30:00 PM
"end_sec": 1540915200 # October 30, 2018 4:00:00 PM
}
}
],
}
]リアルタイム アップデートを送信するタイミング
空き状況が変更されるたびに、リアルタイム更新を継続的に送信する必要があります。これは、お客様のシステムと Google のシステム間で空き状況を同期させるために、1 日 1 回送信する必要がある包括的な空き状況フィードに加えて行われるものです。