CalendarList

Коллекция календарей в списке календарей пользователя. См. также Calendars и CalendarList .

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

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

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Имя свойства Ценить Описание Примечания
accessRole string Действующая роль доступа, которую имеет аутентифицированный пользователь в календаре. Только для чтения. Возможные значения:
  • « freeBusyReader » — обеспечивает доступ для чтения информации о занятости.
  • « reader » — предоставляет доступ для чтения календаря. Частные события будут видны пользователям с доступом для чтения, но подробности о них будут скрыты.
  • « writer » — обеспечивает доступ к календарю для чтения и записи. Частные события будут видны пользователям с правами записи, а подробности событий будут видны.
  • « owner » — указывает право собственности на календарь. Эта роль имеет все разрешения роли писателя, а также дополнительную возможность просматривать списки ACL и управлять ими.
backgroundColor string Основной цвет календаря в шестнадцатеричном формате « #0088aa ». Это свойство заменяет свойство colorId на основе индекса. Чтобы установить или изменить это свойство, вам необходимо указать colorRgbFormat=true в параметрах методов вставки , обновления и исправления . Необязательный. записываемый
colorId string Цвет календаря. Это идентификатор, ссылающийся на запись в разделе calendar определения цветов (см. конечную точку цветов ). Это свойство заменяется свойствами backgroundColor и foregroundColor , и его можно игнорировать при использовании этих свойств. Необязательный. записываемый
conferenceProperties nested object Свойства конференций для этого календаря, например, какие типы конференций разрешены.
conferenceProperties. allowedConferenceSolutionTypes[] list Типы конференц-решений, которые поддерживаются для этого календаря.

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

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

defaultReminders[] list Напоминания по умолчанию, которые аутентифицированный пользователь имеет для этого календаря. записываемый
defaultReminders[]. method string Метод, используемый в этом напоминании. Возможные значения:
  • « email » — напоминания отправляются по электронной почте.
  • « popup » — напоминания отправляются через всплывающее окно пользовательского интерфейса.

Требуется при добавлении напоминания.

записываемый
defaultReminders[]. minutes integer Количество минут до начала события, когда должно сработать напоминание. Допустимые значения: от 0 до 40320 (4 недели в минутах).

Требуется при добавлении напоминания.

записываемый
deleted boolean Была ли эта запись списка календарей удалена из списка календарей. Только для чтения. Необязательный. По умолчанию установлено значение Ложь.
description string Описание календаря. Необязательный. Только для чтения.
etag etag ETag ресурса.
foregroundColor string Цвет переднего плана календаря в шестнадцатеричном формате « #ffffff ». Это свойство заменяет свойство colorId на основе индекса. Чтобы установить или изменить это свойство, вам необходимо указать colorRgbFormat=true в параметрах методов вставки , обновления и исправления . Необязательный. записываемый
hidden boolean Скрыт ли календарь из списка. Необязательный. Атрибут возвращается только в том случае, если календарь скрыт, и в этом случае значение равно true . записываемый
id string Идентификатор календаря.
kind string Тип ресурса ("calendar#calendarListEntry").
location string Географическое положение календаря в виде текста в произвольной форме. Необязательный. Только для чтения.
notificationSettings object Уведомления, которые получает авторизованный пользователь для этого календаря. записываемый
notificationSettings. notifications[] list Список уведомлений, установленных для этого календаря.
notificationSettings.notifications[]. method string Метод, используемый для доставки уведомления. Возможное значение:
  • « email » — уведомления отправляются по электронной почте.

Требуется при добавлении уведомления.

записываемый
notificationSettings.notifications[]. type string Тип уведомления. Возможные значения:
  • « eventCreation » — уведомление отправляется, когда в календарь добавляется новое событие.
  • « eventChange » — уведомление отправляется при изменении события.
  • « eventCancellation » — уведомление отправляется при отмене события.
  • « eventResponse » — уведомление отправляется, когда участник отвечает на приглашение на мероприятие.
  • « agenda » — повестка дня с событиями дня (рассылается утром).

Требуется при добавлении уведомления.

записываемый
primary boolean Является ли календарь основным календарем аутентифицированного пользователя. Только для чтения. Необязательный. По умолчанию установлено значение Ложь.
selected boolean Отображается ли содержимое календаря в пользовательском интерфейсе календаря. Необязательный. По умолчанию установлено значение Ложь. записываемый
summary string Название календаря. Только для чтения.
summaryOverride string Сводка, которую авторизованный пользователь установил для этого календаря. Необязательный. записываемый
timeZone string Часовой пояс календаря. Необязательный. Только для чтения.

Методы

удалить
Удаляет календарь из списка календарей пользователя.
получать
Возвращает календарь из списка календарей пользователя.
вставлять
Вставляет существующий календарь в список календарей пользователя.
список
Возвращает календари из списка календарей пользователя.
пластырь
Обновляет существующий календарь в списке календарей пользователя. Этот метод поддерживает семантику исправлений. Обратите внимание, что каждый запрос на исправление использует три единицы квоты; предпочитайте использовать get за которым следует update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, остаются без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива.
обновлять
Обновляет существующий календарь в списке календарей пользователя.
смотреть
Следите за изменениями в ресурсах CalendarList.