Events: move
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Verschiebt einen Termin in einen anderen Kalender, d.h. ändert den Organisator eines Termins. Hinweis: Nur default-Ereignisse können verschoben werden. birthday-, focusTime-, fromGmail-, outOfOffice- und workingLocation-Ereignisse können nicht verschoben werden.
Jetzt testen
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
calendarId |
string |
Kalender-ID des Quellkalenders, in dem sich das Ereignis derzeit befindet.
|
eventId |
string |
Ereignis-ID.
|
| Erforderliche Suchparameter |
destination |
string |
Kalender-ID des Zielkalenders, in den der Termin verschoben werden soll.
|
| Optionale Suchparameter |
sendNotifications |
boolean |
Verworfen. Verwende stattdessen sendUpdates.
Ob Benachrichtigungen über die Änderung des Organisators der Veranstaltung gesendet werden sollen. Einige E-Mails werden möglicherweise trotzdem gesendet, auch wenn Sie den Wert auf false festlegen. Der Standardwert ist false.
|
sendUpdates |
string |
Gäste, die über die Änderung des Organisators des Termins benachrichtigt werden sollen.
Zulässige Werte sind:
- „
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 Kalendermigrationen können Sie stattdessen die Methode Events.import verwenden.
|
Autorisierung
Diese Anfrage erfordert eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
| Umfang |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.events.owned |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Events: move\n\n| **Note:** Requires [authorization](#auth).\n\nMoves an event to another calendar, i.e. changes an event's organizer. Note that only `default` events can be moved; `birthday`, `focusTime`, `fromGmail`, `outOfOffice` and `workingLocation` events cannot be moved.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier of the source calendar where the event currently is on. |\n| `eventId` | `string` | Event identifier. |\n| **Required query parameters** |||\n| `destination` | `string` | Calendar identifier of the target calendar where the event is to be moved to. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Deprecated. Please use [sendUpdates](/workspace/calendar/api/v3/reference/events/move#sendUpdates) instead. Whether to send notifications about the change of the event's organizer. Note that some emails might still be sent even if you set the value to `false`. The default is `false`. |\n| `sendUpdates` | `string` | Guests who should receive notifications about the change of the event's organizer. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\": Notifications are sent to all guests. - \"`externalOnly`\": Notifications are sent to non-Google Calendar guests only. - \"`none`\": No notifications are sent. For calendar migration tasks, consider using the [Events.import](/workspace/calendar/api/v3/reference/events/import) method instead. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.events` |\n| `https://www.googleapis.com/auth/calendar.events.owned` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an [Events resource](/workspace/calendar/api/v3/reference/events#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
