reserve_organization_room

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

Verhalten und Grenzen

Reserviert genau einen internen Microsoft-365- oder Google-Workspace-Raum nach ausdrücklichem Nutzerauftrag. Übergib den sichtbaren Raumnamen, keine Anbieter-ID. Der Server löst den Namen im aktuellen Organisationskatalog auf, verlangt genau einen Treffer und prüft unmittelbar vor dem Schreiben die Verfügbarkeit. accountName und provider können gleichnamige Räume unterscheiden. Die Aktion erstellt einen Termin im primären Kalender des gewählten Nutzerkontos und sendet eine Ressourceneinladung an den aufgelösten internen Raum. Beliebige Teilnehmer, E-Mail-Adressen, Zahlungen, Hotels oder externe Veranstaltungsorte sind ausgeschlossen. Die Reservierung lässt sich durch Löschen des erstellten Termins rückgängig machen. requestId muss für die beabsichtigte Reservierung eindeutig sein und bei Wiederholungen unverändert bleiben. bookingStatus=requested bedeutet, dass der Raum noch nicht bestätigt hat.

Berechtigungen

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

rooms:read, calendar:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "roomName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Exact human-readable organization meeting-room name shown to the user, for example Ridian Meeting Room 1."
    },
    "accountName": {
      "description": "Optional human-readable connected account name from search_rooms, used only to disambiguate rooms with the same name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "provider": {
      "description": "Optional calendar provider from search_rooms, used only to disambiguate rooms with the same name.",
      "type": "string",
      "enum": [
        "google",
        "microsoft"
      ]
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Caller-generated stable key for this one intended reservation. Reuse it unchanged only when retrying the same reservation."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Title of the calendar event that will be created for this booking."
    },
    "description": {
      "type": "string",
      "maxLength": 10000
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "ISO 8601 timestamp with an explicit UTC offset, for example 2026-09-14T09:00:00+02:00 or 2026-09-14T07:00:00Z. A timeZone field does not replace the offset."
    },
    "end": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "ISO 8601 timestamp with an explicit UTC offset, for example 2026-09-14T09:00:00+02:00 or 2026-09-14T07:00:00Z. A timeZone field does not replace the offset."
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "roomName",
    "requestId",
    "title",
    "start",
    "end",
    "timeZone"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "reason": {
      "type": "string",
      "enum": [
        "room_catalog_incomplete",
        "room_not_found",
        "room_name_ambiguous",
        "room_not_available"
      ]
    },
    "matchCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "eventId": {
      "type": "string"
    },
    "idempotentReplay": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "idempotencyStatus": {
      "type": "string",
      "enum": [
        "created",
        "replayed",
        "provider_managed"
      ]
    },
    "bookingStatus": {
      "type": "string",
      "enum": [
        "confirmed",
        "declined",
        "tentative",
        "requested"
      ]
    },
    "roomResponseStatus": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "needs-action",
            "accepted",
            "declined",
            "tentative"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "room": {
      "type": "object",
      "properties": {
        "roomId": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "capacity": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "building": {
          "type": "string"
        },
        "floor": {
          "type": "string"
        },
        "features": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "roomId",
        "name"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den Kalenderzustand.

Fehlerbehandlung