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

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 Календарь предлагает следующие способы доставки:

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

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