Напоминания и уведомления

API Google Календаря обеспечивает поддержку напоминаний и уведомлений.

• Напоминания — это сигналы тревоги, срабатывающие в указанное время до начала события.
• Уведомления позволяют пользователям узнавать об изменениях в событиях своего календаря.

Не следует путать уведомления с push-уведомлениями , которые сообщают об изменениях в календаре другому серверу, а не доставляются пользователю.

Для получения более подробной информации об уведомлениях в Google Календаре см. раздел «Изменение уведомлений в Google Календаре» .

Напоминания

Напоминание состоит из:

• Когда показывать напоминание, указывается количество минут до начала мероприятия.
• Способ доставки (см. Механизмы доставки ).

Напоминания можно задавать как для целых календарей, так и для отдельных событий. Пользователи могут установить напоминания по умолчанию для каждого из своих календарей; эти настройки применяются ко всем событиям в данном календаре. Однако пользователи также могут переопределить эти настройки по умолчанию для отдельных событий, заменив их другим набором напоминаний.

Напоминания по умолчанию

Напоминания — это конфиденциальная информация, относящаяся только к авторизованному пользователю; они не передаются между несколькими пользователями. В результате:

• Настройки напоминаний по умолчанию осуществляются с помощью коллекции CalendarList , которая содержит метаданные календаря, специфичные для пользователя.
• Они недоступны через коллекцию Calendars , которая содержит глобальные метаданные, общие для всех пользователей.

При выполнении запроса к списку событий также возвращаются напоминания по умолчанию.

Отмена напоминаний по умолчанию

Чтобы переопределить напоминания по умолчанию при создании или обновлении события, установите параметр reminders.useDefault в значение false и заполните поле reminders.overrides новым установленным напоминанием. Переопределения можно установить только тогда, когда useDefault имеет значение false , как показано в следующем примере:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

Чтобы вернуться к набору напоминаний по умолчанию, обновите параметр reminders.useDefault , установив его значение обратно в true .

Уведомления

Календарь поддерживает следующие типы уведомлений:

• Создание события : Новое событие добавляется в один из календарей пользователя.
• Изменение события : Организатор изменил событие, на которое пользователь был приглашен.
• Отмена мероприятия : Мероприятие, на которое пользователь был приглашен, отменено.
• Ответ участника : Участник изменил свой статус ответа на мероприятие, созданное пользователем.
• Повестка дня : Список всех событий в календаре пользователя, отправляемый в начале дня.

Пользователь может выбрать, какие уведомления включить для каждого календаря, а также способ доставки для каждого типа уведомлений. Эти настройки не передаются другим пользователям. Как и стандартные напоминания, они доступны через коллекцию CalendarList .

Чтобы отправлять участникам уведомления по электронной почте о событиях, которые были добавлены или обновлены с помощью API, вызовите метод insert или update и установите параметр sendUpdates в значение "all" или "externalOnly" .

Механизмы доставки

Google Календарь предлагает следующие способы доставки:

• Всплывающие окна . Они поддерживаются на мобильных платформах и в веб-клиентах.
• Электронное письмо, отправленное сервером.

В таблице ниже показаны поддерживаемые методы для каждого типа напоминаний или уведомлений: