Events: patch

Atualiza um evento. Esse método é compatível com a semântica de patch. Cada solicitação de patch consome três unidades de cota. Use um get seguido de um update. Os valores de campo especificados substituem os valores atuais. Os campos que você não especificar na solicitação permanecem inalterados. Os campos de matriz, se especificados, substituem as matrizes atuais. Isso descarta todos os elementos de matriz anteriores. Teste agora.

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 extrair os IDs de agenda, chame o método calendarList.list. Se você quiser acessar a agenda principal do usuário conectado, use a palavra-chave primary.
eventId string Identificador do 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 participantes, mesmo que nenhum endereço de e-mail real esteja disponível. Ou seja, um valor gerado e inválido será fornecido.
conferenceDataVersion integer Número da versão dos dados da conferência aceitos pelo cliente da API. A versão 0 não oferece suporte a dados de conferência e ignora os dados de conferência no corpo do evento. A versão 1 oferece suporte à cópia de dados de conferência e à criação de novas conferências usando o campo createRequest de dados de conferência. 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 participantes do que o número especificado, apenas o participante será retornado. Opcional.
sendNotifications boolean Obsoleto. Use sendUpdates.

Define 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 podem ser enviados mesmo que você defina o valor como false. O padrão é false.
sendUpdates string Convidados que vão receber notificações sobre a atualização do evento (por exemplo, mudanças no título etc.).

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.
supportsAttachments boolean Se o cliente da API que executa a operação oferece suporte a 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
https://www.googleapis.com/auth/calendar.app.created
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

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, 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.