Events: patch

Atualiza um evento. Este método oferece suporte à semântica de patches. Cada solicitação de patch consome três unidades de cota. Use uma get seguida por uma update. Os valores dos campos especificados substituem os valores existentes. Os campos que você não especificar na solicitação permanecerão inalterados. Campos de matriz, se especificados, substituem as matrizes existentes. Isso descarta quaisquer elementos de matriz anteriores. Faça um teste.

Solicitação

Solicitação HTTP

PATCH 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. Se você quiser acessar a agenda principal do usuário conectado no momento, use a palavra-chave "primary".
eventId string Identificador de evento.
Parâmetros de consulta opcionais
alwaysIncludeEmail boolean Descontinuado e ignorado. Um valor sempre será retornado no campo email para o organizador, o criador e os convidados, mesmo que nenhum endereço de e-mail real esteja disponível (ou seja, será gerado um valor gerado que não funciona).
conferenceDataVersion integer Número da versão dos dados da conferência compatível com o cliente da API. A versão 0 não aceita dados de videoconferência e ignora os dados de videoconferência no corpo do evento. A versão 1 permite suporte para cópia de ConferenceData, bem como para criação de novas conferências usando o campo createRequest de conferênciasData. O padrão é 0. Os valores aceitáveis são de 0 a 1, inclusive.
maxAttendees integer O número máximo de participantes a serem incluídos na resposta. Se houver mais participantes do que o número especificado, apenas o participante será retornado. Opcional.
sendNotifications boolean Obsoleto. Use sendUpdates.

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

Os valores aceitáveis são:
  • "all": as notificações são enviadas para 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 da agenda, use o método Events.import.
supportsAttachments boolean Se a operação de execução do cliente da API oferece suporte a anexos de evento. 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 as partes relevantes de um recurso Events, de acordo com as regras de semântica de patch.

Resposta

Se for bem-sucedido, este 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.