Events: move
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Move um evento para outra agenda, ou seja, muda o organizador de um evento. Somente os eventos default podem ser movidos. Os eventos birthday, focusTime, fromGmail, outOfOffice e workingLocation não podem ser movidos.
Teste agora.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
calendarId |
string |
Identificador da agenda de origem em que o evento está atualmente.
|
eventId |
string |
Identificador do evento.
|
| Parâmetros de consulta obrigatórios |
destination |
string |
Identificador da agenda de destino para onde o evento será movido.
|
| Parâmetros de consulta opcionais |
sendNotifications |
boolean |
Obsoleto. Use sendUpdates.
Informa se é necessário enviar notificações sobre a mudança do organizador do evento. Alguns e-mails ainda podem ser enviados mesmo que você defina o valor como false. O padrão é false.
|
sendUpdates |
string |
Convidados que precisam receber notificações sobre a mudança do organizador do evento.
Os valores aceitáveis são:
- "
all": as notificações são enviadas a todos os convidados.
- "
externalOnly": as notificações são enviadas apenas para convidados que não são do Google Agenda.
- "
none": nenhuma notificação é enviada. Para tarefas de migração de agenda, use o método Events.import.
|
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos:
| Escopo |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.events.owned |
Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um recurso Events no corpo da resposta.
Confira!
Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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."]]
