update_event

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

Verhalten und Grenzen

Ändert nur die angegebenen Felder eines Termins mit canEdit=true und überschreibt deren bisherige Werte. Nur für eigene Termine und Serien ohne Gäste oder Konferenzdaten; die Aktion kann dadurch keine Besprechungsupdates versenden. Bei einer Zeitänderung müssen start, end und timeZone gemeinsam angegeben werden. Für ein Vorkommen einer Serie übergib die occurrenceId aus demselben Ergebnis von list_events oder search_events: Dann ändert sich nur dieses Vorkommen (Zeit, Dauer, Titel, Beschreibung, Ort oder Verfügbarkeit), alle anderen Vorkommen bleiben unverändert. Mit editScope=series ändern sich nur Titel, Beschreibung und Ort der ganzen Serie; ihr Zeitplan bleibt unverändert, und einzeln geänderte Vorkommen können ihre eigenen Werte behalten. Ein Vorkommen einer ganztägigen Serie lässt sich nicht verschieben.

Berechtigungen

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

calendar:read, calendar:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "minLength": 1
    },
    "eventId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "occurrenceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "editScope": {
      "type": "string",
      "enum": [
        "occurrence",
        "series"
      ]
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "location": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "freeBusyStatus": {
      "type": "string",
      "enum": [
        "free",
        "busy"
      ]
    }
  },
  "required": [
    "calendarId",
    "eventId"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "eventId": {
      "type": "string"
    }
  },
  "required": [
    "ok",
    "eventId"
  ],
  "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