Calendars

Подборка всех существующих календарей. См. также Calendars vs CalendarList .

Список способов использования этого ресурса см. в конце этой страницы.

Представление ресурсов 

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
Название объекта недвижимости Ценить Описание Примечания
autoAcceptInvitations boolean Принимает ли этот календарь приглашения автоматически. Действительно только для календарей ресурсов.
conferenceProperties nested object Свойства календаря конференций, например, какие типы конференций разрешены.
conferenceProperties. allowedConferenceSolutionTypes[] list Типы конференционных решений, поддерживаемых в рамках данного календаря.

Возможные значения:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Необязательный.

dataOwner string Адрес электронной почты владельца календаря. Настраивается только для дополнительных календарей. Только для чтения.
description string Описание календаря. Необязательно. записываемый
etag etag ETag ресурса.
id string Идентификатор календаря. Для получения идентификаторов вызовите метод calendarList.list() .
kind string Тип ресурса (" calendar#calendar ).
location string Географическое местоположение календаря в виде произвольного текста. Необязательно. записываемый
summary string Название календаря. записываемый
timeZone string Часовой пояс календаря. (Отформатирован как название в базе данных часовых поясов IANA, например, "Europe/Zurich".) Необязательно. записываемый

Методы

прозрачный
Очищает основной календарь. Эта операция удаляет все события, связанные с основным календарем учетной записи.
удалить
Удаляет дополнительный календарь. Используйте calendars.clear для очистки всех событий в основном календаре.
получать
Возвращает метаданные для календаря.
вставлять
Создает дополнительный календарь.

Пользователь, прошедший аутентификацию и отправивший запрос, становится владельцем данных нового календаря.

пластырь
Обновляет метаданные календаря. Этот метод поддерживает семантику патчей. Обратите внимание, что каждый запрос на обновление расходует три единицы квоты; предпочтительнее использовать запрос get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, не указанные в запросе, остаются неизменными. Если указаны поля массива, они перезаписывают существующие массивы; при этом отбрасываются все предыдущие элементы массива.
передача права собственности
Позволяет передавать дополнительный календарь между пользователями в рамках организации Google Workspace. Требуется аутентификация пользователя с правами администратора «Управление календарями» и одной из следующих областей авторизации:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
В запросе установите useAdminAccess в true . Для переноса дополнительный календарь должен быть активен. Перенос отключенных или удаленных календарей не поддерживается.
обновлять
Обновляет метаданные календаря.