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 предлагает следующие способы доставки:
- Всплывающие окна . Поддерживаются на мобильных платформах и в веб-клиентах.
- Электронное письмо, отправленное сервером.
В следующей таблице показаны поддерживаемые методы для каждого типа напоминаний или уведомлений:
| Неожиданно возникнуть | Электронная почта | ||
|---|---|---|---|
| Напоминания | Напоминания по умолчанию | ✓ | ✓ |
| Переопределить напоминания | ✓ | ✓ | |
| Уведомления | Создание события | ❌ | ✓ |
| Изменение события | ❌ | ✓ | |
| Отмена мероприятия | ❌ | ✓ | |
| Ответ участника | ❌ | ✓ | |
| Повестка дня | ❌ | ✓ |