create_event

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

Verhalten und Grenzen

Erstellt einen Einzeltermin ohne Gäste in einem beschreibbaren Google-, Microsoft- oder CalDAV-Kalender. Begrenzte Wochenserien sind nur für Google und Microsoft möglich; CalDAV-Serien werden in der Kalender-App angelegt. Für eine Serie übergib recurrence mit frequency=weekly, count von 2 bis 104 Vorkommen einschließlich des ersten und optional interval in Wochen, standardmäßig 1. Das letzte Vorkommen muss innerhalb von 104 Wochen liegen. Die Serie wiederholt sich am Wochentag und zur lokalen Uhrzeit von start in timeZone. Bei Serien müssen start und end auf demselben lokalen Tag liegen und dürfen eine Zeitumstellung weder einschließen noch darin liegen. Bestätige Wiederholung und Gesamtanzahl vor der Anlage mit dem Nutzer. requestId bezeichnet die gesamte Serie und bleibt bei Wiederholungen unverändert. start und end benötigen einen UTC-Offset; timeZone muss eine IANA-Zeitzone sein. Für einen ganztägigen Termin in Google, Microsoft oder CalDAV setze allDay auf true und übergib statt start und end die Daten startDate und endDate im Format JJJJ-MM-TT. endDate ist der letzte Tag und zählt mit: 27. bis 29. Oktober sind startDate 2026-10-27 und endDate 2026-10-29. Für einen eintägigen Termin entfällt endDate. Ein Ganztagstermin umfasst höchstens 366 Tage und kann keine Serie sein. timeZone bleibt Pflicht und verschiebt die Daten nie. update_event ändert das Datum eines Ganztagstermins nicht. Das Werkzeug sendet keine Einladungen. update_event und delete_event ändern Einzeltermine und einzelne Vorkommen eigener Serien ohne Gäste; update_event kann außerdem eine ganze Serie umbenennen.

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
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "recurrence": {
      "type": "object",
      "properties": {
        "frequency": {
          "type": "string",
          "const": "weekly"
        },
        "interval": {
          "type": "integer",
          "minimum": 1,
          "maximum": 104
        },
        "count": {
          "type": "integer",
          "minimum": 2,
          "maximum": 104
        }
      },
      "required": [
        "frequency",
        "count"
      ],
      "additionalProperties": false
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "description": {
      "type": "string",
      "maxLength": 10000
    },
    "location": {
      "type": "string",
      "maxLength": 1000
    },
    "start": {
      "description": "Timed events only: start with UTC offset. Omit when allDay is true.",
      "type": "string"
    },
    "end": {
      "description": "Timed events only: end with UTC offset. Omit when allDay is true.",
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "freeBusyStatus": {
      "type": "string",
      "enum": [
        "free",
        "busy"
      ]
    },
    "allDay": {
      "description": "true for an all-day event; then use startDate and endDate instead of start and end.",
      "type": "boolean"
    },
    "startDate": {
      "description": "All-day events only: first day as YYYY-MM-DD.",
      "type": "string"
    },
    "endDate": {
      "description": "All-day events only: last day as YYYY-MM-DD, included. Omit for a one-day event.",
      "type": "string"
    }
  },
  "required": [
    "calendarId",
    "requestId",
    "title",
    "timeZone"
  ],
  "additionalProperties": false
}

Ausgabe

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