Calendars: update
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Обновляет метаданные для календаря. Попробуйте сейчас .
Запрос
HTTP-запрос
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId
Параметры
Имя параметра | Ценить | Описание |
---|
Параметры пути |
calendarId | string | Идентификатор календаря. Для получения идентификаторов календаря вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово " primary ". |
Авторизация
Для этого запроса требуется авторизация по крайней мере в одной из следующих областей:
Объем |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendars |
Более подробную информацию смотрите на странице аутентификации и авторизации .
Текст запроса
В теле запроса укажите ресурс Calendars со следующими свойствами:
Имя свойства | Ценить | Описание | Примечания |
---|
Дополнительные свойства |
description | string | Описание календаря. Необязательно. | записываемый |
location | string | Географическое положение календаря в виде текста свободной формы. Необязательно. | записываемый |
summary | string | Название календаря. | записываемый |
timeZone | string | Часовой пояс календаря. (Отформатирован как имя базы данных часовых поясов IANA, например, «Европа/Цюрих».) Необязательно. | записываемый |
Попробуйте!
Используйте API Explorer ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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."]]