list_absences

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

Verhalten und Grenzen

Listet Abwesenheiten (Urlaub, Krankheit, Fortbildung, Sonstiges) der Mitglieder des Workspace, die einen Zeitraum berühren, höchstens 92 Tage, standardmäßig die nächsten 92 Tage. Während einer Abwesenheit hat das Mitglied keine freien Zeiten, und Round Robin überspringt es. Den Grund gibt es nur bei eigenen Abwesenheiten oder für Owner und Admins, sonst ist er null. Liefert auch die Mitglieder mit user_id, zur Wahl einer Vertretung.

Berechtigungen

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

bookings:read

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "from": {
      "description": "Start of the period, ISO date-time with offset. Default: now.",
      "type": "string",
      "maxLength": 40
    },
    "to": {
      "description": "End of the period (exclusive). Default and maximum: from + 92 days.",
      "type": "string",
      "maxLength": 40
    },
    "user_id": {
      "description": "Only this member's absences.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "absences": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "absence_id": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "start": {
            "type": "string"
          },
          "end": {
            "type": "string"
          },
          "all_day": {
            "type": "boolean"
          },
          "first_day": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_day": {
            "type": [
              "string",
              "null"
            ]
          },
          "time_zone": {
            "type": "string"
          },
          "reason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "vacation",
                  "sick",
                  "training",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "substitute": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "user_id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "user_id",
                  "name"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "absence_id",
          "user_id",
          "name",
          "start",
          "end",
          "all_day",
          "first_day",
          "last_day",
          "time_zone",
          "reason",
          "substitute"
        ],
        "additionalProperties": false
      }
    },
    "members": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "user_id",
          "name"
        ],
        "additionalProperties": false
      }
    },
    "console_url": {
      "type": "string"
    }
  },
  "required": [
    "absences",
    "members",
    "console_url"
  ],
  "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