Events: move
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Déplace un événement vers un autre agenda, c'est-à-dire modifie l'organisateur de l'événement. Notez que seuls les événements default
peuvent être déplacés. Les événements birthday
, focusTime
, fromGmail
, outOfOffice
et workingLocation
ne peuvent pas être déplacés.
Essayez maintenant.
Requête
Requête HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
Paramètres
Nom du paramètre |
Valeur |
Description |
Paramètres de chemin d'accès |
calendarId |
string |
Identifiant de l'agenda source dans lequel l'événement est actuellement défini.
|
eventId |
string |
Identifiant de l'événement.
|
Paramètres de requête obligatoires |
destination |
string |
Identifiant de l'agenda cible vers lequel l'événement doit être déplacé.
|
Paramètres de requête facultatifs |
sendNotifications |
boolean |
Obsolète. Veuillez utiliser sendUpdates à la place.
Indique si des notifications doivent être envoyées concernant le changement d'organisateur de l'événement. Notez que certains e-mails peuvent toujours être envoyés, même si vous définissez la valeur sur false . La valeur par défaut est false .
|
sendUpdates |
string |
Les invités qui doivent recevoir des notifications concernant le changement d'organisateur de l'événement.
Les valeurs acceptées sont les suivantes :
- "
all ": les notifications sont envoyées à tous les invités.
- "
externalOnly ": les notifications ne sont envoyées qu'aux invités qui n'utilisent pas Google Agenda.
- "
none ": aucune notification n'est envoyée. Pour les tâches de migration d'agenda, nous vous conseillons d'utiliser plutôt la méthode Events.import.
|
Autorisation
Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants:
Champ d'application |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.events.owned |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie une ressource "Events" dans le corps de la réponse.
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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."]]