Calendars: update

Aktualisiert die Metadaten für einen Kalender. Jetzt testen

Anfrage

HTTP-Anfrage

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den primären Kalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine Kalenderressource mit den folgenden Attributen an:

Property-Name Wert Beschreibung Hinweise
Optionale Attribute
description string Beschreibung des Kalenders. Optional. Bearbeitbar
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

Antwort

Bei Erfolg gibt diese Methode eine Calendars-Ressource im Antworttext zurück.

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.