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

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

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

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