Фон API календаря
Концепции календаря
Календарь Google построен на нескольких основных концепциях:
- Событие
- Одно событие в календаре, содержащее такую информацию, как название события, время начала и окончания, а также участников.
- Календарь
- Отдельная запись календаря, содержащая метаданные календаря, например описание.
- Список календарей
- Список всех календарей в списке календарей пользователя в пользовательском интерфейсе календаря.
- Параметр
- Предпочтения пользователя из пользовательского интерфейса Календаря, например часовой пояс пользователя.
- список управления доступом
- Единственное правило управления доступом, содержащее такую информацию, как тип и область действия правила.
Модель данных API календаря
Ресурс — это отдельный объект данных с уникальным идентификатором. API календаря работает с пятью типами ресурсов:
- Ресурс событий
- Представляет одно событие в календаре.
- Ресурс календарей
- Представляет метаданные для отдельного календаря.
- Ресурс списка календаря
- Представляет метаданные для отдельного календаря, который отображается в списке календарей пользователя в пользовательском интерфейсе.
- Ресурс настроек
- Представляет одно пользовательское предпочтение из пользовательского интерфейса календаря.
- Ресурс ACL
- Представляет список ACL.
Модель данных Calendar API основана на группах ресурсов, называемых коллекциями:
- Коллекция событий
- Состоит из всех ресурсов событий в рамках определенного ресурса календаря .
- Коллекция календарных списков
- Состоит из всех ресурсов CalendarList для конкретного пользователя.
- Коллекция настроек
- Состоит из всех ресурсов настроек для конкретного пользователя.
- Коллекция ACL
- Состоит из всех ресурсов ACL , примененных к определенному календарю.