respond_to_booking_request

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Nimmt eine Buchungsanfrage für eine Terminart mit manueller Bestätigung an oder lehnt sie ab (Status requested in list_bookings). Annehmen trägt den Termin in den Kalender des Gastgebers ein und schickt der buchenden Person eine Bestätigung; Ablehnen schickt ihr eine Mail, mit Grund falls angegeben, und gibt die Zeit frei. Nicht rückgängig zu machen; vorher mit dem Nutzer abstimmen.

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

bookings:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "booking_id from list_bookings."
    },
    "decision": {
      "type": "string",
      "enum": [
        "accept",
        "decline"
      ]
    },
    "reason": {
      "description": "Only for decline. Shown to the booker.",
      "type": "string",
      "maxLength": 1000
    }
  },
  "required": [
    "booking_id",
    "decision"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "booking_id",
    "status"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

Fehlerbehandlung