Calendars: update
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 de acceso |
calendarId |
string |
Es el identificador del calendario. Para recuperar los IDs de calendario, llama al método calendarList.list. Si deseas 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 autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso de Calendarios con las siguientes propiedades:
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
| Propiedades opcionales |
description |
string |
Descripción del calendario. Opcional. |
admite escritura
|
location |
string |
Es la 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 |
Es 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
|
Respuesta
Si la respuesta es correcta, este método muestra un recurso de Calendarios en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Calendars: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates metadata for a calendar.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|--------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.app.created` |\n| `https://www.googleapis.com/auth/calendar.calendars` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply a [Calendars resource](/workspace/calendar/api/v3/reference/calendars#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|----------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nResponse\n--------\n\nIf successful, this method returns a [Calendars resource](/workspace/calendar/api/v3/reference/calendars#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
