設定取消時限

如何新增取消時限

取消視窗會定義取消和修改按鈕何時啟用。這表示取消和修改功能將無法在使用者確認電子郵件中運作，並會從所有其他介面 (包括確認對話方塊) 中消失。

取消時段可透過兩種方式啟用：服務層級和時段層級。以下將說明在這些層級指定視窗的程序。

如果同時設定服務層級和時段層級的取消時段，則會套用時段層級的取消時段。如果兩者都未設定，取消期預設為時段開始時間 (也就是使用者可在最後一刻取消預約)。

服務水準定義

如要啟用服務層級取消時段，請在 Service 動態饋給中指定 rules.min_advance_online_canceling。這個欄位應設為預訂開始時間前需要預訂的秒數。舉例來說，如果預訂只能在開始時間前 24 小時取消，這個欄位就會設為 86400 (因此，如果預訂時間為下午 3 點，則只能在前一天下午 3 點前取消)。這會套用至該服務的所有時段 (除非已由時段層級定義覆寫)。

JSON

{
  "service": [
    {
      "rules": {
        "min_advance_online_canceling": 86400
      }
    }
  ]
}

時段層級定義

在可預訂時段層級，欄位稱為 scheduling_rule_overrides.last_online_cancellable_sec。這個欄位是特定時段可取消的最後時間 (EPOCH 時間戳記)。這會套用至指定此值的每個單一版位。

JSON

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

警告：在動態饋給中實作取消時間窗格，並不代表您不需要實作及處理 BookingFailure OUTSIDE_CANCELLATION_WINDOW。在某些極端情況下 (例如瀏覽器分頁停滯)，UpdateBooking 可能會在指定的取消時間範圍外傳送。收到 UpdateBooking 後，您的系統必須確認變更發生在指定的取消時段內，如果不是，請回應 UpdateBookingResponse.booking_failure = OUTSIDE_CANCELLATION_WINDOW。