最短の事前予約時間を設定する

最短の事前予約時間の設定

特定のサービスやスロットを一定の期間以上前に予約できるようにしたい場合がよくあります。これらは、サービスレベルまたは可用性レベルで設定できます。両方で設定されている場合は、アベイラビリティ レベルの設定が使用されます。

サービスレベルの定義

サービスレベルでは、このフィールドは rules.min_advance_booking と呼ばれます。このフィールドには、予約開始時間の何秒前に予約を行う必要があるかを設定します。たとえば、予約は常に開始時間の 1 時間前までに行う必要がある場合、このフィールドは 3600 に設定されます（午後 3 時の予約は午後 2 時まで予約できます）。これは、そのサービスのすべてのスロットに適用されます（スロットレベルの定義でオーバーライドされていない限り）。

JSON

"service": [
  {
    "rules": {
      "min_advance_booking": 3600
    }
  }
]

スロットレベルの定義

アベイラビリティ スロットレベルでは、このフィールドは scheduling_rule_overrides.last_bookable_sec と呼ばれます。このフィールドは、特定のスロットを予約できる最終時間（EPOCH タイムスタンプ）です。これは、これが指定された各スロットに適用されます。

JSON

"service_availability": [
  {
    "availability": {
      "scheduling_rule_overrides": {
        "last_bookable_sec": 1468081800
        }
    }
  }
]

警告: フィードに事前予約の上限を実装しても、予約が許可された予約期間内かどうかを確認して処理する必要がある場合、BookingFailure SLOT_UNAVAILABLE は必要です。CreateBooking が予約期間外に送信されるというエッジケース（ブラウザのタブが停止しているなど）が発生する可能性があります。CreateBooking を受信したシステムは、予約が許可された予約期間内に行われることを確認する必要があります。期間内に行われない場合は、CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE で応答します。