Events: patch

Atualiza um evento. Este método oferece suporte à semântica de patches. Observe que cada solicitação de patch consome três unidades de cota. Prefira usar um get seguido por um update. Os valores de campo especificados substituem os valores atuais. Os campos que não forem especificados na solicitação não serão alterados. Os campos de matriz, se especificados, substituem as matrizes existentes. Isso descarta os elementos anteriores da matriz. Faça o 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 Obsoleto 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, será fornecido um valor gerado que não funciona).
conferenceDataVersion integer Número da versão de dados de videoconferência aceitos pelo 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 a cópia de ConferenceData, bem como a criação de novas conferências usando o campo createRequest de organizationData. 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 do que o número especificado de participantes, somente o participante será retornado. Opcional.
sendNotifications boolean Obsoleto. Use sendUpdates.

Se você quer 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 foram 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 é enviada. Para tarefas de migração de agendas, use o método Events.import.
supportsAttachments boolean Se o cliente da API que está executando 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

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