Aktualisiert einen Termin. Diese Methode unterstützt die Patch-Semantik. Jede Patchanfrage verbraucht drei Kontingenteinheiten. Idealerweise sollte get
gefolgt von update
verwendet werden. Die von Ihnen angegebenen Feldwerte ersetzen die vorhandenen Werte. Felder, die Sie nicht in der Anfrage angeben, bleiben unverändert. Array-Felder, sofern angegeben, überschreiben die vorhandenen Arrays. Dadurch werden alle vorherigen Array-Elemente verworfen.
Jetzt ausprobieren
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 Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Schlüsselwort „primary “.
|
eventId |
string |
Ereignis-ID. |
Optionale Abfrageparameter | ||
alwaysIncludeEmail |
boolean |
Eingestellt und ignoriert. Im Feld email wird für den Organisator, den Ersteller und die Teilnehmer immer ein Wert zurückgegeben, auch wenn keine echte E-Mail-Adresse verfügbar ist. Es wird also ein generierter, nicht funktionierender Wert angegeben.
|
conferenceDataVersion |
integer |
Versionsnummer der vom API-Client unterstützten Konferenzdaten. In Version 0 wird davon ausgegangen, dass keine Konferenzdaten unterstützt werden, und ignoriert Konferenzdaten im Text des Termins. Version 1 ermöglicht das Kopieren von ConferenceData sowie das Erstellen neuer Konferenzen mit dem createRequest-Feld von ConferenceData. Der Standardwert ist 0.
Zulässige Werte: 0 bis 1 .
|
maxAttendees |
integer |
Die maximale Anzahl von Teilnehmern, die in die Antwort aufgenommen werden sollen. Wenn es mehr als die angegebene Anzahl von Teilnehmern gibt, wird nur der Teilnehmer zurückgegeben. Optional. |
sendNotifications |
boolean |
Veraltet. Verwende stattdessen sendUpdates. Gibt an, ob Benachrichtigungen zur Terminaktualisierung (z. B. Änderungen der Beschreibung) gesendet werden sollen. Hinweis: Einige E-Mails werden möglicherweise trotzdem gesendet, wenn Sie den Wert auf false festlegen. Der Standardwert ist false .
|
sendUpdates |
string |
Gäste, die Benachrichtigungen zur Terminaktualisierung (z. B. Titeländerungen usw.) erhalten sollen.
Zulässige Werte sind:
|
supportsAttachments |
boolean |
Gibt an, ob der API-Client, der einen Vorgang ausführt, Ereignisanhänge unterstützt. Optional. Die Standardeinstellung ist "False". |
Autorisierung
Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext die relevanten Teile einer Ereignisressource gemäß den Regeln der Patch-Semantik an.
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ereignisressource im Antworttext zurückgegeben.
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.