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. Prefira usar 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 vão permanecer inalterados. Os campos de matriz, se especificados, substituem as matrizes atuais, descartando todos os elementos 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 recuperar os IDs da 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 não funcional será fornecido).
conferenceDataVersion integer Número da versão dos dados de conferência compatíveis com o cliente da API. A versão 0 não tem suporte para dados de conferência e ignora esses dados no corpo do evento. A versão 1 permite a cópia de ConferenceData e a criação de novas conferências usando o campo createRequest de conferenceData. O padrão é 0. Os valores aceitos vão de 0 a 1, inclusive.
eventLabelVersion integer Número da versão do recurso de rótulo de evento compatível com o cliente da API. A versão 0 não tem suporte para rótulos de eventos e processa o campo colorId para gerenciamento de cores. A versão 1 permite a compatibilidade com rótulos de eventos e processa o eventLabelId no corpo do evento. Nesse caso, o campo colorId é ignorado. O padrão é 0. Os valores aceitos vão de 0 a 1.
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.

Indica se as notificações sobre a atualização do evento (por exemplo, mudanças na descrição etc.) serão enviadas. 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 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 usam o Google Agenda.
  • "none": nenhuma notificação é enviada. Para tarefas de migração do Google Agenda, use o método Events.import.
supportsAttachments boolean Se o cliente da API que está realizando a operação é 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
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.