Calendars: update

Atualiza os metadados de uma agenda. Faça o teste agora.

Solicitação

Solicitação HTTP

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

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 no momento, use a palavra-chave "primary".

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.app.created
https://www.googleapis.com/auth/calendar.calendars

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 Calendars com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades opcionais
description string Descrição da agenda. Opcional. gravável
labelProperties nested object Propriedades de rótulo definidas nessa agenda. Se especificado, substitui as propriedades de rótulo atuais. Se não for especificado, as propriedades de rótulo permanecerão inalteradas. gravável
labelProperties.eventLabels[] list Rótulos de eventos definidos nessa agenda. Se estiver presente ao atualizar a agenda, ele vai substituir os rótulos de eventos atuais.

Estenda a lista para adicionar um novo rótulo de evento e remova entidades da lista para excluir um rótulo da agenda.

Cada agenda pode ter no máximo 200 rótulos.

 gravável
labelProperties.eventLabels[].backgroundColor string Cor de plano de fundo do rótulo no formato hexadecimal, como "#039be5". Os eventos com esse rótulo são exibidos nessa cor. Obrigatório. gravável
labelProperties.eventLabels[].id string O ID do rótulo. Opcional ao inserir um novo rótulo. Se não for fornecido, um ID exclusivo será gerado. Obrigatório ao atualizar um rótulo.

Se fornecido, o ID precisa ser exclusivo na agenda e seguir o formato UUID.

 gravável
labelProperties.eventLabels[].name string Nome do rótulo. Opcional.

Se fornecido, ele precisa ter no máximo 50 caracteres.

 gravável
location string Localização geográfica da agenda como texto de formato livre. Opcional. gravável
summary string Título da agenda. gravável
timeZone string O fuso horário da agenda. (Formatado como um nome do banco de dados de fusos horários da IANA, por exemplo, "Europe/Zurich".) Opcional. gravável

Resposta

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

Confira!

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