Events: patch

Aktualisiert einen Termin. Diese Methode unterstützt die Patch-Semantik. Beachten Sie, dass jede Patchanfrage drei Kontingenteinheiten verbraucht. verwenden Sie am besten get gefolgt von update. Die von Ihnen angegebenen Feldwerte ersetzen die vorhandenen Werte. Felder, die Sie nicht in der Anfrage angeben, bleiben unverändert. Sofern angegeben, werden die vorhandenen Arrays mit Array-Feldern überschrieben. 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 zum Abrufen von Kalender-IDs die Methode calendarList.list auf. Wenn Sie auf den Hauptkalender des derzeit angemeldeten Nutzers zugreifen möchten, verwenden Sie die „primary“ Keyword.
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 (d.h. ein generierter, nicht funktionsfähiger Wert wird bereitgestellt).
conferenceDataVersion integer Versionsnummer der vom API-Client unterstützten Konferenzdaten. Version 0 setzt voraus, dass Konferenzdaten nicht unterstützt werden, und ignoriert Konferenzdaten im Text des Termins. Version 1 ermöglicht die Unterstützung für das Kopieren von ConferenceData sowie die Erstellung neuer Konferenzen mithilfe des Felds 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 mehr als die angegebene Anzahl von Teilnehmern vorhanden ist, wird nur der Teilnehmer zurückgegeben. Optional.
sendNotifications boolean Verworfen. Verwenden Sie stattdessen sendUpdates.

Gibt an, ob Benachrichtigungen zur Terminaktualisierung gesendet werden sollen (z. B. bei Änderungen an der Beschreibung). Beachten Sie, dass einige E-Mails möglicherweise trotzdem gesendet werden, auch wenn Sie den Wert auf false setzen. Der Standardwert ist false.
sendUpdates string Gäste, die über die Terminaktualisierung benachrichtigt werden sollen (z. B. Titeländerungen usw.).

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • „all“: Benachrichtigungen werden an alle Gäste gesendet.
  • „externalOnly“: Benachrichtigungen werden nur an Gäste gesendet, die Google Kalender nicht verwenden.
  • „none“: Es werden keine Benachrichtigungen gesendet. Für Aufgaben der Kalendermigration sollten Sie stattdessen die Methode Events.import verwenden.
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 nach den Regeln der Patch-Semantik an.

Antwort

Wenn der Vorgang erfolgreich ist, gibt diese Methode eine Ereignisressource im Antworttext zurück.

Testen!

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