list_calendars

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

Verhalten und Grenzen

Listet die Kalender aus verbundenen Google-, Microsoft-365- und CalDAV-Konten, die dieser Assistent nutzen darf, mit ID, Name, Anbieter, Zeitzone und ob sie nur lesbar sind. Die IDs gelten für list_events, search_events, find_available_times und die Termin-Werkzeuge. Kalender, die der Nutzer diesem Assistenten nicht freigegeben hat, fehlen; das Ergebnis meldet, wie viele Konten aus welchem Grund ausgeschlossen wurden. Begrenzt der Tarif des Workspace die Zahl der Kalender je Assistent, sagt tarifHinweis das. providerPreset bezeichnet den erkannten CalDAV-Dienst, zum Beispiel apple; CalDAV allein bedeutet nicht Apple.

Berechtigungen

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

calendar:read

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kalender": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "providerPreset": {
            "type": "string"
          },
          "color": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          },
          "readOnly": {
            "type": "boolean"
          },
          "art": {
            "type": "string",
            "enum": [
              "arbeit",
              "persoenlich"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "provider",
          "readOnly",
          "art"
        ],
        "additionalProperties": false
      }
    },
    "ausgeschlossen": {
      "type": "object",
      "properties": {
        "andereOrganisation": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "arbeitGesperrt": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "inaktivesKonto": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "tenantUnbekannt": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "andereOrganisation",
        "arbeitGesperrt",
        "inaktivesKonto",
        "tenantUnbekannt"
      ],
      "additionalProperties": false
    },
    "tarifHinweis": {
      "type": "string"
    }
  },
  "required": [
    "kalender",
    "ausgeschlossen"
  ],
  "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