Calendars

Eine Sammlung aller vorhandenen Kalender. Weitere Informationen finden Sie unter Kalender im Vergleich zu CalendarList.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean
}
Property-Name Wert Beschreibung Hinweise
autoAcceptInvitations boolean Gibt an, ob für diesen Kalender Einladungen automatisch angenommen werden. Gilt nur für Ressourcenkalender.
conferenceProperties nested object Konferenzattribute für diesen Kalender, z. B. welche Arten von Konferenzen zulässig sind.
conferenceProperties.allowedConferenceSolutionTypes[] list Die Arten von Konferenzlösungen, die für diesen Kalender unterstützt werden.

Die möglichen Werte sind:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Optional.
dataOwner string Die E-Mail-Adresse des Inhabers des Kalenders. Nur für sekundäre Kalender festgelegt. Schreibgeschützt.
description string Beschreibung des Kalenders. Optional. Bearbeitbar
etag etag ETag der Ressource.
id string Kennung des Kalenders. Rufen Sie die Methode calendarList.list() auf, um IDs abzurufen.
kind string Typ der Ressource („calendar#calendar“).
labelProperties nested object Label-Attribute, die für diesen Kalender definiert sind. Wenn angegeben, werden die vorhandenen Label-Eigenschaften überschrieben. Wenn nichts angegeben ist, bleiben die Label-Attribute unverändert. Bearbeitbar
labelProperties.eventLabels[] list In diesem Kalender definierte Terminlabels. Wenn diese beim Aktualisieren des Kalenders vorhanden sind, werden die vorhandenen Terminlabels ersetzt.

Erweitern Sie die Liste, um ein neues Ereignislabel hinzuzufügen, und entfernen Sie Elemente aus der Liste, um ein Label aus dem Kalender zu löschen.

Jeder Kalender kann maximal 200 Labels haben.

 Bearbeitbar
labelProperties.eventLabels[].backgroundColor string Hintergrundfarbe des Labels im Hexadezimalformat, z. B. "#039be5". Ereignisse mit diesem Label werden in dieser Farbe angezeigt. Erforderlich. Bearbeitbar
labelProperties.eventLabels[].id string Die ID des Labels. Optional beim Einfügen eines neuen Labels. Wenn nicht angegeben, wird eine eindeutige ID generiert. Erforderlich, wenn ein Label aktualisiert wird.

Wenn die ID angegeben wird, muss sie im Kalender eindeutig sein und dem UUID-Format entsprechen.

 Bearbeitbar
labelProperties.eventLabels[].name string Der Name des Labels Optional.

Wenn angegeben, darf sie höchstens 50 Zeichen lang sein.

 Bearbeitbar
location string Geografischer Standort des Kalenders als Freiformtext. Optional. Bearbeitbar
summary string Titel des Kalenders. Bearbeitbar
timeZone string Die Zeitzone des Kalenders. (Formatiert als Name aus der IANA-Zeitzonendatenbank, z.B. „Europe/Zurich“.) Optional. Bearbeitbar

Methoden

klarer
Löscht einen primären Kalender. Bei diesem Vorgang werden alle Termine gelöscht, die mit dem primären Kalender eines Kontos verknüpft sind.
Delete
Löscht einen sekundären Kalender. Verwenden Sie calendars.clear, um alle Termine in primären Kalendern zu löschen.
get
Gibt Metadaten für einen Kalender zurück.
insert
Erstellt einen sekundären Kalender.

Der authentifizierte Nutzer für die Anfrage wird zum Dateninhaber des neuen Kalenders.

patch
Aktualisiert die Metadaten für einen Kalender. Diese Methode unterstützt die Patch-Semantik. Beachten Sie, dass für jede Patch-Anfrage drei Kontingenteinheiten verbraucht werden. Verwenden Sie daher lieber ein get gefolgt von einem update. Die von Ihnen angegebenen Feldwerte ersetzen die vorhandenen Werte. Felder, die Sie in der Anfrage nicht angeben, bleiben unverändert. Array-Felder überschreiben, sofern angegeben, die vorhandenen Arrays. Dadurch werden alle vorherigen Array-Elemente verworfen.
transferOwnership
Überträgt einen sekundären Kalender zwischen Nutzern innerhalb einer Google Workspace-Organisation. Erfordert die Nutzerauthentifizierung mit der Administratorberechtigung Kalender verwalten und einen der folgenden Autorisierungsbereiche:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
 Legen Sie in der Anfrage useAdminAccess auf true fest. Der sekundäre Kalender muss aktiv sein, damit er übertragen werden kann. Das Übertragen deaktivierter oder gelöschter Kalender wird nicht unterstützt.
Aktualisierung
Aktualisiert die Metadaten für einen Kalender.