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 Schlüsselwort „primary“.

Autorisierung

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

Bereich
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 In diesem Kalender definierte Label-Eigenschaften. Wenn angegeben, werden die vorhandenen Labelattribute überschrieben. Wenn nichts angegeben ist, bleiben die Labelattribute unverändert. Bearbeitbar
labelProperties.eventLabels[] list In diesem Kalender definierte Terminlabels. Wenn dieses Feld beim Aktualisieren des Kalenders vorhanden ist, werden die vorhandenen Terminlabels ersetzt.

Erweitern Sie die Liste, um ein neues Terminlabel hinzuzufügen, und entfernen Sie Entitäten 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". Termine 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 eine ID angegeben wird, muss sie im Kalender eindeutig sein und dem UUID-Format entsprechen.

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

Falls angegeben, darf dieser Wert 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
workingHours object Stellt die Informationen zu den Arbeitszeiten des Nutzers dar. Nur für primäre Kalender von Google Workspace-Nutzern verfügbar. Wenn Sie die Arbeitszeit aktualisieren möchten, muss das gesamte Arbeitszeitobjekt übergeben werden. Wenn nicht angegeben (oder als „null“ oder leeres Objekt übergeben), bleiben die vorhandenen Arbeitszeiten unverändert. Wenn Sie die Arbeitszeit deaktivieren oder den Zeitplan löschen möchten, setzen Sie workingHoursEnabled auf „false“ und lassen Sie availableTimes weg oder übergeben Sie eine leere Liste. Bearbeitbar
workingHours.availableTimes[] list Arbeitszeit Jeder Verfügbarkeitszeitraum stellt den Arbeitszeitblock des Nutzers an einem Tag dar. Bearbeitbar
workingHours.availableTimes[].dayOfWeek string Wochentag Erforderlich. Mögliche Werte sind:
  • „monday“
  • „tuesday“
  • „wednesday“
  • „thursday“
  • „friday“
  • „saturday“
  • „sunday“
Bearbeitbar
workingHours.availableTimes[].periodEnd integer Ende des Zeitraums in Minuten ab Beginn des Tages (exklusiv). Erforderlich. Bearbeitbar
workingHours.availableTimes[].periodStart integer Beginn des Zeitraums in Minuten ab Tagesbeginn (einschließlich). Erforderlich. Bearbeitbar
workingHours.workingHoursEnabled boolean Gibt an, ob die Arbeitszeiten für diesen Kalender aktiviert sind. Kann nicht auf „true“ gesetzt werden, wenn availableTimes leer ist. Bearbeitbar

Antwort

Bei Erfolg gibt diese Methode eine Kalenderressource im Antworttext zurück.

Testen!

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