Actualiza los metadatos de un calendario. Pruébalo ahora.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarIdPará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 conectado, 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 Autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso Calendars 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 las etiquetas definidas en este calendario. Si se especifica, reemplaza las propiedades de la etiqueta existente. 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 este parámetro 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 |
Es el 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. Opcional cuando se inserta una etiqueta nueva. Si no se proporciona, se generará un ID único. Es obligatorio 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 50 caracteres como máximo. |
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 |
La 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 |
workingHours |
object |
Representa la información sobre el horario laboral del usuario. Solo está disponible para los calendarios principales de los usuarios de Google Workspace. Para actualizar el horario laboral, se debe pasar todo el objeto de horario laboral. Si no se especifica (o se pasa como nulo o un objeto vacío), el horario laboral existente no se modifica. Para inhabilitar el horario laboral o borrar el programa, establece workingHoursEnabled como falso (y omite availableTimes o pasa una lista vacía). |
admite escritura |
workingHours.availableTimes[] |
list |
Horario laboral Cada período de disponibilidad representa el bloque de horario laboral del usuario durante un día. | admite escritura |
workingHours.availableTimes[].dayOfWeek |
string |
Día de la semana. Obligatorio. Los valores posibles son los siguientes:
|
admite escritura |
workingHours.availableTimes[].periodEnd |
integer |
Es el final del período, en minutos desde el comienzo del día, exclusivo. Obligatorio. | admite escritura |
workingHours.availableTimes[].periodStart |
integer |
Es el inicio del período, en minutos desde el comienzo del día, inclusive. Obligatorio. | admite escritura |
workingHours.workingHoursEnabled |
boolean |
Indica si el horario laboral está habilitado para este calendario. No se puede establecer como verdadero cuando availableTimes está vacío. |
admite escritura |
Respuesta
Si se ejecuta correctamente, este método devuelve un recurso Calendars en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en vivo y ver la respuesta.