Events: move
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Mueve un evento a otro calendario, es decir, cambia el organizador de un evento. Ten en cuenta que solo se pueden mover los eventos default
; no se pueden mover los eventos birthday
, focusTime
, fromGmail
, outOfOffice
y workingLocation
.
Pruébalo ahora.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
Parámetros
Nombre del parámetro |
Valor |
Descripción |
Parámetros de ruta de acceso |
calendarId |
string |
Es el identificador de calendario del calendario de origen en el que se encuentra el evento actualmente.
|
eventId |
string |
Es el identificador del evento.
|
Parámetros de consulta obligatorios |
destination |
string |
Es el identificador del calendario de destino al que se moverá el evento.
|
Parámetros de consulta opcionales |
sendNotifications |
boolean |
Obsoleta. En su lugar, usa sendUpdates.
Determina si se deben enviar notificaciones sobre el cambio del organizador del evento. Ten en cuenta que es posible que se envíen algunos correos electrónicos incluso si estableces el valor en false . El valor predeterminado es false .
|
sendUpdates |
string |
Invitados que deben recibir notificaciones sobre el cambio del organizador del evento.
Los valores aceptables son los siguientes:
- "
all ": Las notificaciones se envían a todos los invitados.
- "
externalOnly ": Las notificaciones solo se envían a los invitados que no usan el Calendario de Google.
- "
none ": No se envían notificaciones. Para las tareas de migración de calendarios, considera usar el método Events.import.
|
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes permisos:
Alcance |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.events.owned |
Para obtener más información, consulta la página autenticación y autorización.
Cuerpo de la solicitud
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un recurso de eventos en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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."]]