Aktualisiert einen Termin. 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.
Jetzt testen
Anfrage
HTTP-Anfrage
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
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“.
|
eventId |
string |
Ereigniskennung. |
| Optionale Suchparameter | ||
alwaysIncludeEmail |
boolean |
Verworfen und ignoriert. Für den Organisator, den Ersteller und die Teilnehmer wird immer ein Wert im Feld email zurückgegeben, auch wenn keine echte E-Mail-Adresse verfügbar ist. In diesem Fall wird ein generierter, nicht funktionierender Wert angegeben.
|
conferenceDataVersion |
integer |
Versionsnummer der vom API-Client unterstützten Konferenzdaten. Bei Version 0 werden keine Konferenzdaten unterstützt und Konferenzdaten im Text des Termins werden ignoriert. Version 1 bietet Unterstützung für das Kopieren von ConferenceData sowie für das Erstellen neuer Konferenzen mit dem Feld „createRequest“ von „conferenceData“. Der Standardwert ist 0.
Zulässige Werte: 0 bis 1.
|
eventLabelVersion |
integer |
Versionsnummer der Funktion für Ereignislabels, die vom API-Client unterstützt wird. Bei Version 0 wird davon ausgegangen, dass keine Ereignislabels unterstützt werden. Das Feld colorId wird für die Farbverwaltung verarbeitet. Mit Version 1 werden Ereignislabels unterstützt und die eventLabelId im Ereignis-Body verarbeitet. In diesem Fall wird das Feld colorId ignoriert. Der Standardwert ist 0.
Zulässige Werte sind 0 bis einschließlich 1.
|
maxAttendees |
integer |
Die maximale Anzahl der Teilnehmer, die in der Antwort enthalten sein sollen. Wenn es mehr Teilnehmer als die angegebene Anzahl gibt, wird nur der Teilnehmer zurückgegeben. Optional. |
sendNotifications |
boolean |
Verworfen. Verwenden Sie stattdessen sendUpdates. Gibt an, ob Benachrichtigungen über die Aktualisierung des Termins gesendet werden sollen, z. B. bei Änderungen der Beschreibung. Auch wenn Sie den Wert auf false setzen, werden möglicherweise weiterhin einige E‑Mails gesendet. Der Standardwert ist false.
|
sendUpdates |
string |
Gäste, die Benachrichtigungen zu Terminaktualisierungen erhalten sollen, z. B. zu Titeländerungen.
Zulässige Werte sind:
|
supportsAttachments |
boolean |
Gibt an, ob der API-Client, der den Vorgang ausführt, Ereignisanhänge unterstützt. Optional. Die Standardeinstellung ist "False". |
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.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext die relevanten Teile einer Events-Ressource gemäß den Regeln der Patch-Semantik an.
Antwort
Bei Erfolg gibt diese Methode eine Events-Ressource im Antworttext zurück.
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.