remove_room_from_event

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

Verhalten und Grenzen

Macht eine abgeschlossene Ridian-Raumreservierung rückgängig, indem ausschließlich der zugehörige interne Microsoft-365- oder Google-Workspace-Raum als Teilnehmer entfernt wird. Termin und übrige Teilnehmer bleiben erhalten. Übergib dieselbe sichtbare Raumauswahl und die ursprüngliche requestId der Reservierung. Der Server prüft die Anbieter-IDs anhand des gespeicherten Reservierungsnachweises. Eine identische Wiederholung ist sicher und liefert changed=false.

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 room name used for the original reservation."
    },
    "accountName": {
      "description": "Optional human-readable connected account name used to disambiguate duplicate room names.",
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "provider": {
      "description": "Optional provider used to disambiguate duplicate room names.",
      "type": "string",
      "enum": [
        "google",
        "microsoft"
      ]
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "The unchanged requestId from the original reserve_organization_room call."
    }
  },
  "required": [
    "roomName",
    "requestId"
  ],
  "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"
      ]
    },
    "matchCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "eventId": {
      "type": "string"
    },
    "changed": {
      "type": "boolean"
    },
    "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