Events: patch

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Aktualisiert einen Termin. Diese Methode unterstützt die Patch-Semantik. Beachten Sie, dass jede Patchanfrage drei Kontingenteinheiten verbraucht. Verwenden Sie vorzugsweise ein get, gefolgt von einem update. Die von Ihnen angegebenen Feldwerte ersetzen die vorhandenen Werte. Felder, die Sie nicht in der Anfrage angeben, bleiben unverändert. Array-Felder, falls 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 Keyword „primary“.
eventId string Ereignis-ID.
Optionale Suchparameter
alwaysIncludeEmail boolean Eingestellt und ignoriert. Es wird immer ein Wert im Feld email für den Organisator, den Ersteller und die Gäste zurückgegeben, auch wenn keine echte E-Mail-Adresse verfügbar ist.
conferenceDataVersion integer Versionsnummer der vom API-Client unterstützten Konferenzdaten In Version 0 wird davon ausgegangen, dass keine Konferenzdaten unterstützt werden. Daher werden die Konferenzdaten im Text der Veranstaltung ignoriert. Version 1 unterstützt das Kopieren von ConferenceData-Daten sowie das Erstellen neuer Konferenzen mit dem Feld „createRequest“ 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. Bitte verwende stattdessen sendUpdates.

Gibt an, ob Benachrichtigungen über die Ereignisaktualisierung gesendet werden sollen (z. B. Änderungen an der Beschreibung). Beachten Sie, dass einige E-Mails auch dann gesendet werden können, wenn Sie den Wert auf false setzen. Der Standardwert ist false.
sendUpdates string Gäste, die Benachrichtigungen über die Terminaktualisierung erhalten sollen (z. B. Titeländerungen).

Folgende Werte sind zulässig:
  • „all“: Benachrichtigungen werden an alle Gäste gesendet.
  • „externalOnly“: Benachrichtigungen werden nur an Personen gesendet, die Google Kalender nicht nutzen.
  • „none“: Es werden keine Benachrichtigungen gesendet. Verwenden Sie für Aufgaben zur Kalendermigration stattdessen die Methode Events.import.
supportsAttachments boolean Gibt an, ob der API-Client, der Vorgänge 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 Ressource vom Typ „Ereignisse“ im Antworttext zurückgegeben.

Testen!

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