Events: update

Atualiza um evento. Esse método não oferece suporte à semântica de patch e sempre atualiza todo o recurso do evento. Para fazer uma atualização parcial, execute uma get seguida por uma update usando ETags para garantir a atomicidade. Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
calendarId string Identificador da agenda. Para recuperar IDs de agendas, chame o método calendarList.list. Para acessar a agenda principal do usuário conectado, use "primary" palavra-chave.
eventId string Identificador do evento.
Parâmetros de consulta opcionais
alwaysIncludeEmail boolean Obsoleto e ignorado. Um valor será sempre retornado no campo email para o organizador, o criador e os participantes, mesmo que nenhum endereço de e-mail real esteja disponível (ou seja, será fornecido um valor gerado e que não funciona).
conferenceDataVersion integer Número da versão dos dados de conferência compatíveis com o cliente da API. A versão 0 pressupõe que não há suporte a dados de conferência e ignora os dados de conferência no corpo do evento. A versão 1 permite o suporte para cópia de ConferenceData, bem como para a criação de novas conferências usando o campo createRequest de educationData. O padrão é 0. Os valores aceitos vão de 0 a 1, inclusive.
maxAttendees integer O número máximo de participantes a serem incluídos na resposta. Se houver mais do que o número especificado de participantes, somente o participante será retornado. Opcional.
sendNotifications boolean Obsoleto. Em vez disso, use sendUpdates.

Se as notificações sobre a atualização do evento serão enviadas (por exemplo, mudanças na descrição etc.). Alguns e-mails ainda poderão ser enviados mesmo se você definir o valor como false. O padrão é false.
sendUpdates string Convidados que devem receber notificações sobre atualizações do evento (por exemplo, mudanças de título, etc.).

Os valores aceitáveis são:
  • "all": as notificações serão enviadas para todos os convidados.
  • "externalOnly": as notificações são enviadas apenas para convidados que não usam o Google Agenda.
  • "none": nenhuma notificação foi enviada. Para tarefas de migração de agendas, considere usar o método Events.import.
supportsAttachments boolean Se a operação do cliente da API é compatível com anexos de eventos. Opcional. O valor padrão é falso.

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

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, informe um recurso Events com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
end nested object O horário de término (exclusivo) do evento. Para um evento recorrente, esse é o horário de término da primeira instância.
start nested object O horário de início (inclusivo) do evento. Para um evento recorrente, esse é o horário de início da primeira instância.
Propriedades opcionais
anyoneCanAddSelf boolean Se qualquer pessoa pode convidar a si mesma para o evento (descontinuado). Opcional. O valor padrão é falso. gravável
attachments[].fileUrl string Link do URL para o anexo.

Para adicionar anexos de arquivo do Google Drive, use o mesmo formato da propriedade alternateLink do recurso Files na API Drive.

Obrigatório ao adicionar um anexo.

 gravável
attendees[] list Os participantes do evento. Consulte o guia Eventos com convidados para mais informações sobre como agendar eventos com outros usuários da agenda. As contas de serviço precisam usar a delegação de autoridade em todo o domínio para preencher a lista de participantes. gravável
attendees[].additionalGuests integer Número de hóspedes adicionais. Opcional. O padrão é 0. gravável
attendees[].comment string O comentário de resposta do convidado. Opcional. gravável
attendees[].displayName string O nome do participante, se disponível. Opcional. gravável
attendees[].email string O endereço de e-mail do participante, se disponível. Este campo precisa estar presente ao adicionar um participante. Precisa ser um endereço de e-mail válido, de acordo com a RFC5322.

Obrigatório ao adicionar um participante.

 gravável
attendees[].optional boolean Indica se este é um participante opcional. Opcional. O valor padrão é falso. gravável
attendees[].resource boolean Se o participante é um recurso. Só pode ser definido quando o participante é adicionado ao evento pela primeira vez. Modificações subsequentes são ignoradas. Opcional. O valor padrão é falso. gravável
attendees[].responseStatus string O status de resposta do convidado. Os valores possíveis são:
  • "needsAction" - O convidado não respondeu ao convite (recomendado para novos eventos).
  • "declined" - O convidado recusou o convite.
  • "tentative" - O convidado aceitou temporariamente o convite.
  • "accepted" - O convidado aceitou o convite.
 gravável
attendeesOmitted boolean Se os participantes podem ter sido omitidos da representação do evento. Ao recuperar um evento, isso pode ocorrer devido a uma restrição especificada pelo parâmetro de consulta maxAttendee. Ao atualizar um evento, isso pode ser usado apenas para atualizar a resposta do participante. Opcional. O valor padrão é falso. gravável
colorId string A cor do evento. Esse é um ID que se refere a uma entrada na seção event da definição de cores (consulte o endpoint de cores). Opcional. gravável
conferenceData nested object As informações relacionadas a videoconferências, como detalhes de uma videoconferência do Google Meet. Para criar detalhes de videoconferências, use o campo createRequest. Para manter as mudanças, lembre-se de definir o parâmetro de solicitação conferenceDataVersion como 1 para todas as solicitações de modificação de eventos. gravável
description string É a descrição do evento. Pode conter HTML. Opcional. gravável
end.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
end.dateTime datetime A hora, como um valor combinado de data e hora (formatado de acordo com RFC3339). É necessário um ajuste de fuso horário, a menos que ele seja explicitamente especificado em timeZone. gravável
end.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, esse campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/fim do evento. gravável
extendedProperties.private object Propriedades particulares da cópia do evento que aparece na agenda. gravável
extendedProperties.shared object Propriedades que são compartilhadas entre as cópias do evento nos outros participantes. agendas. gravável
focusTimeProperties nested object Dados do evento "Horário de concentração". Usado se eventType for focusTime. gravável
gadget.display string O modo de exibição do gadget. Obsoleto. Os valores possíveis são:
  • "icon" - O gadget é exibido ao lado do título do evento na visualização da agenda.
  • "chip" - O gadget é exibido quando o evento é clicado.
 gravável
gadget.height integer A altura do gadget em pixels. A altura precisa ser um número inteiro maior que zero. Opcional. Obsoleto. gravável
gadget.preferences object Preferências. gravável
gadget.title string O título do gadget. Obsoleto. gravável
gadget.type string O tipo do gadget. Obsoleto. gravável
gadget.width integer A largura do gadget em pixels. A largura precisa ser um número inteiro maior que zero. Opcional. Obsoleto. gravável
guestsCanInviteOthers boolean Se outros participantes, além do organizador, podem convidar outras pessoas para o evento. Opcional. O padrão é "True". gravável
guestsCanModify boolean Se outros participantes, além do organizador, podem modificar o evento. Opcional. O valor padrão é falso. gravável
guestsCanSeeOtherGuests boolean Se outros participantes, além do organizador, podem ver quem são os participantes do evento. Opcional. O padrão é "True". gravável
location string A localização geográfica do evento como texto em formato livre. Opcional. gravável
originalStartTime.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
originalStartTime.dateTime datetime A hora, como um valor combinado de data e hora (formatado de acordo com RFC3339). É necessário um ajuste de fuso horário, a menos que ele seja explicitamente especificado em timeZone. gravável
originalStartTime.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, esse campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/fim do evento. gravável
outOfOfficeProperties nested object Dados de eventos "fora do escritório". Usado se eventType for outOfOffice. gravável
recurrence[] list Lista de linhas RRULE, EXRULE, RDATE e EXDATE para um evento recorrente, conforme especificado no RFC5545. Observe que as linhas DTSTART e DTEND não são permitidas neste campo. os horários de início e término do evento são especificados nos campos start e end. Este campo é omitido para eventos únicos ou instâncias de eventos recorrentes. gravável
reminders.overrides[] list Se o evento não usar os lembretes padrão, listará os lembretes específicos do evento ou, se não definido, indicará que nenhum lembrete foi definido para o evento. O número máximo de lembretes de substituição é cinco. gravável
reminders.overrides[].method string O método usado pelo lembrete. Os valores possíveis são:
  • "email" - Os lembretes são enviados por e-mail.
  • "popup" - Os lembretes são enviados por uma janela pop-up na interface.

Obrigatório ao adicionar um lembrete.

 gravável
reminders.overrides[].minutes integer Número de minutos antes do início do evento quando o lembrete deve ser acionado. Os valores válidos estão entre 0 e 40320 (4 semanas em minutos).

Obrigatório ao adicionar um lembrete.

 gravável
reminders.useDefault boolean Indica se os lembretes padrão da agenda se aplicam ao evento. gravável
sequence integer Número de sequência de acordo com o iCalendar. gravável
source.title string Título da fonte por exemplo, o título de uma página da Web ou o assunto de um e-mail. gravável
source.url string URL da origem que aponta para um recurso. O esquema do URL precisa ser HTTP ou HTTPS. gravável
start.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
start.dateTime datetime A hora, como um valor combinado de data e hora (formatado de acordo com RFC3339). É necessário um ajuste de fuso horário, a menos que ele seja explicitamente especificado em timeZone. gravável
start.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, esse campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/fim do evento. gravável
status string Status do evento. Opcional. Os valores possíveis são:
  • "confirmed" - O evento foi confirmado. Esse é o status padrão.
  • "tentative" - O evento está temporariamente confirmado.
  • "cancelled" - O evento é cancelado (excluído). O método list retorna eventos cancelados somente na sincronização incremental (quando syncToken ou updatedMin são especificados) ou se a flag showDeleted está definida como true. O método get sempre as retorna.

    Um status cancelado representa dois estados diferentes, dependendo do tipo de evento:

    1. As exceções canceladas de um evento recorrente não cancelado indicam que essa instância não deve mais ser apresentada ao usuário. Os clientes devem armazenar esses eventos durante todo o ciclo de vida do evento recorrente pai.

      Só é garantido que as exceções canceladas terão valores para os campos id, recurringEventId e originalStartTime preenchidos. Os outros campos podem estar vazios.

    2. Todos os outros eventos cancelados representam eventos excluídos. Os clientes precisam remover as cópias sincronizadas localmente. Esses eventos cancelados vão desaparecer em algum momento. Por isso, não espere que eles fiquem disponíveis indefinidamente.

      Só é garantido que os eventos excluídos terão o campo id preenchido.

    Na agenda do organizador, os eventos cancelados continuam expondo os detalhes deles (resumo, local etc.) para que possam ser restaurados (cancelar exclusão). Da mesma forma, os eventos para os quais o usuário foi convidado e removidos manualmente continuam a fornecer detalhes. No entanto, as solicitações de sincronização incremental com showDeleted definido como falso não vão retornar esses detalhes.

    Se um evento alterar o organizador (por exemplo, com a operação move) e o organizador original não estiver na lista de participantes, o evento cancelado será mantido, e apenas o campo id será preenchido.

gravável
summary string Título do evento. gravável
transparency string Se o evento bloqueia o tempo na agenda. Opcional. Os valores possíveis são:
  • "opaque" - valor padrão. O evento bloqueia o horário na agenda. Isso equivale a definir Mostrar-me como como Ocupado na interface do Agenda.
  • "transparent" - O evento não bloqueia o horário na agenda. Isso equivale a definir Mostrar-me como como Disponível na interface do Agenda.
 gravável
visibility string Visibilidade do evento. Opcional. Os valores possíveis são:
  • "default" - usa a visibilidade padrão para eventos na agenda. Esse é o valor padrão.
  • "public" - O evento é público e os detalhes dele ficam visíveis para todos os leitores da agenda.
  • "private" - O evento é privado e somente os participantes podem visualizar os detalhes.
  • "confidential" - O evento é privado. Esse valor é fornecido por motivos de compatibilidade.
 gravável
workingLocationProperties nested object Dados de eventos do local de trabalho. gravável
workingLocationProperties.customLocation object Se presente, especifica que o usuário está trabalhando em um local personalizado. gravável
workingLocationProperties.customLocation.label string Um marcador extra opcional para mais informações. gravável
workingLocationProperties.homeOffice any value Se presente, especifica que o usuário está trabalhando em casa. gravável
workingLocationProperties.officeLocation object Se presente, especifica que o usuário está trabalhando em um escritório. gravável
workingLocationProperties.officeLocation.buildingId string Um identificador de edifício opcional. Ela deve fazer referência ao ID de um edifício no banco de dados de Recursos da organização. gravável
workingLocationProperties.officeLocation.deskId string Um identificador opcional do espaço de trabalho. gravável
workingLocationProperties.officeLocation.floorId string Um identificador de andar opcional. gravável
workingLocationProperties.officeLocation.floorSectionId string Um identificador opcional da seção do andar. gravável
workingLocationProperties.officeLocation.label string O nome do escritório que é exibido nos clientes do Google Agenda na Web e em dispositivos móveis. Recomendamos que você mencione o nome de um edifício no banco de dados de Recursos da organização. gravável
workingLocationProperties.type string Tipo de local de trabalho. Os valores possíveis são:
  • "homeOffice" - O usuário está trabalhando em casa.
  • "officeLocation" - O usuário está trabalhando em um escritório.
  • "customLocation" - O usuário está trabalhando de um local personalizado.
Todos os detalhes são especificados em um subcampo do nome especificado, mas esse campo pode estar ausente se estiver vazio. Todos os outros campos serão ignorados.

Obrigatório ao adicionar propriedades de local de trabalho.

 gravável

Resposta

Se for bem-sucedido, esse método retornará um recurso Events no corpo da resposta.

Exemplos

Observação: os exemplos de código disponíveis para esse método não representam todas as linguagens de programação compatíveis. Consulte a página de bibliotecas cliente para ver uma lista de linguagens compatíveis.

Java

Usa a biblioteca cliente de Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve the event from the API
Event event = service.events().get("primary", "eventId").execute();

// Make a change
event.setSummary("Appointment at Somewhere");

// Update the event
Event updatedEvent = service.events().update("primary", event.getId(), event).execute();

System.out.println(updatedEvent.getUpdated());

Python

Usa a biblioteca cliente de Python.

# First retrieve the event from the API.
event = service.events().get(calendarId='primary', eventId='eventId').execute()

event['summary'] = 'Appointment at Somewhere'

updated_event = service.events().update(calendarId='primary', eventId=event['id'], body=event).execute()

# Print the updated date.
print updated_event['updated']

PHP

Usa a biblioteca cliente de PHP.

// First retrieve the event from the API.
$event = $service->events->get('primary', 'eventId');

$event->setSummary('Appointment at Somewhere');

$updatedEvent = $service->events->update('primary', $event->getId(), $event);

// Print the updated date.
echo $updatedEvent->getUpdated();

Ruby

Usa a biblioteca de cliente Ruby.

event = client.get_event('primary', 'eventId')
event.summary = 'Appointment at Somewhere'
result = client.update_event('primary', event.id, event)
print result.updated

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.