Calendars: update

Actualiza los metadatos de un calendario. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta
calendarId string Es el identificador del calendario. Para recuperar los IDs de calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió actualmente, usa la palabra clave "primary".

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes permisos:

Alcance
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Calendarios con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades opcionales
description string Es la descripción del calendario. Opcional. admite escritura
labelProperties nested object Son las propiedades de la etiqueta definidas en este calendario. Si se especifica, reemplaza las propiedades de etiqueta existentes. Si no se especifica, las propiedades de la etiqueta no se modifican. admite escritura
labelProperties.eventLabels[] list Son las etiquetas de eventos definidas en este calendario. Si está presente cuando se actualiza el calendario, reemplazará las etiquetas de eventos existentes.

Extiende la lista para agregar una nueva etiqueta de evento y quita entidades de la lista para borrar una etiqueta del calendario.

Cada calendario puede tener un máximo de 200 etiquetas.

 admite escritura
labelProperties.eventLabels[].backgroundColor string Color de fondo de la etiqueta en formato hexadecimal, como "#039be5". Los eventos con esta etiqueta se muestran en este color. Obligatorio. admite escritura
labelProperties.eventLabels[].id string Es el ID de la etiqueta. Es opcional cuando se inserta una etiqueta nueva. Si no se proporciona, se generará un ID único. Se requiere cuando se actualiza una etiqueta.

Si se proporciona, el ID debe ser único dentro del calendario y seguir el formato UUID.

 admite escritura
labelProperties.eventLabels[].name string Es el nombre de la etiqueta. Opcional.

Si se proporciona, debe tener un máximo de 50 caracteres.

 admite escritura
location string Ubicación geográfica del calendario como texto de formato libre. Opcional. admite escritura
summary string Es el título del calendario. admite escritura
timeZone string Zona horaria del calendario. (Con el formato de un nombre de la base de datos de zonas horarias de IANA, p.ej., "Europe/Zurich"). Opcional. admite escritura

Respuesta

Si la respuesta es correcta, este método devuelve un recurso de Calendarios en el cuerpo de la respuesta.

Pruébalo

Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.