create_calendar

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

Verhalten und Grenzen

Erstellt einen zusätzlichen Google-Kalender im Eigentum des verbundenen Nutzers. accountCalendarName muss genau und eindeutig dem sichtbaren Namen eines vorhandenen Google-Kalenders aus list_calendars entsprechen. Er dient nur zur Kontoauswahl; der vorhandene Kalender wird nicht verändert. requestId muss für den beabsichtigten Kalender eindeutig sein und nur bei Wiederholungen unverändert wiederverwendet werden. Der erstellte Kalender wird als von Ridian angelegt gespeichert, damit delete_created_calendar ihn später sicher entfernen kann.

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:manage

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "accountCalendarName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Exact visible name of one Google calendar returned by list_calendars; used only to choose the connected Google account. The named existing calendar is not modified."
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable caller-generated key for this one intended calendar. Reuse it unchanged only when retrying the same creation."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Visible name for the new secondary Google calendar."
    },
    "timeZone": {
      "description": "Optional IANA time zone for the new calendar, for example Europe/Berlin.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "accountCalendarName",
    "requestId",
    "name"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "calendarId": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "provider": {
      "type": "string",
      "const": "google"
    },
    "timeZone": {
      "type": "string"
    },
    "idempotentReplay": {
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "calendarId",
    "name",
    "provider",
    "idempotentReplay"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

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

Fehlerbehandlung