API календаря обеспечивает поддержку напоминаний и уведомлений.
- Напоминания — это сигналы тревоги, срабатывающие в определенное время перед началом события.
- Уведомления позволяют пользователям узнавать об изменениях событий в своем календаре.
Последний пункт не следует путать с push-уведомлениями , которые вместо доставки пользователю уведомляют другой сервер об изменениях в календаре.
Более подробную информацию об уведомлениях в Календаре Google можно найти в разделе Изменение уведомлений Календаря Google .
Напоминания
Напоминание состоит из:
- Когда показывать напоминание, выраженное в минутах до начала события
- Используемый метод доставки (см. Механизмы доставки )
Напоминания можно задать для целых календарей и для отдельных событий. Пользователи могут устанавливать напоминания по умолчанию для каждого из своих календарей; эти значения по умолчанию применяются ко всем событиям в этом календаре. Однако пользователи также могут переопределять эти значения по умолчанию для отдельных событий, заменяя их другим набором напоминаний.
Напоминания по умолчанию
Напоминания — это конфиденциальная информация, относящаяся к аутентифицированному пользователю; они не распространяются среди нескольких пользователей. В результате:
- Напоминания по умолчанию управляются с помощью коллекции CalendarList, которая содержит метаданные календаря пользователя.
- Они недоступны через коллекцию «Календари», содержащую глобальные метаданные, общие для всех пользователей.
Напоминания по умолчанию также возвращаются при выполнении запроса списка событий.
Переопределение напоминаний по умолчанию
Чтобы переопределить напоминания по умолчанию при вставке или изменении события, установите для параметра reminders.useDefault значение false и заполните параметр reminders.overrides новым набором напоминаний.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
Чтобы вернуться к набору напоминаний по умолчанию, выполните обновление параметра reminders.useDefault , вернув ему значение true .
Уведомления
Календарь поддерживает следующие типы уведомлений:
- Создание события : новое событие добавляется в один из календарей пользователя.
- Изменение события : организатор изменил событие, на которое был приглашен пользователь.
- Отмена мероприятия : мероприятие, на которое был приглашен пользователь, отменено.
- Ответ участника : участник мероприятия, созданного пользователем, изменил свой статус ответа.
- Повестка дня : список всех событий в календаре пользователя, отправляемый в начале дня.
Пользователь может решить, какие уведомления включить для каждого календаря и способ доставки для каждого типа уведомлений. Эти настройки не передаются другим пользователям. Подобно напоминаниям по умолчанию, они доступны через коллекцию CalendarList.
Чтобы отправлять уведомления по электронной почте участникам о событиях, которые были вставлены или обновлены с помощью API, вызовите метод insert или update и установите для параметра sendUpdates значение "all" или "externalOnly" .
Механизмы доставки
Google Calendar предлагает следующие способы доставки:
- Всплывающие окна . Поддерживаются на мобильных платформах и в веб-клиентах.
- Электронное письмо, отправленное сервером.
В следующей таблице показаны поддерживаемые методы для каждого типа напоминания или уведомления:
| Неожиданно возникнуть | Электронная почта | ||
|---|---|---|---|
| Напоминания | Напоминания по умолчанию | ✓ | ✓ |
| Переопределить напоминания | ✓ | ✓ | |
| Уведомления | Создание событий | ❌ | ✓ |
| Изменение события | ❌ | ✓ | |
| Отмена мероприятия | ❌ | ✓ | |
| Ответ участника | ❌ | ✓ | |
| Повестка дня | ❌ | ✓ |