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