Przypomnienia i powiadomienia

Interfejs Calendar API obsługuje przypomnienia i powiadomienia.

  • Przypomnienia to alarmy uruchamiane na określony czas przed rozpoczęciem wydarzenia.
  • Powiadomienia pozwalają użytkownikom na informowanie o zmianach w wydarzeniach w ich kalendarzu.

Tego drugiego elementu nie należy mylić z powiadomieniami push, które nie są dostarczane do użytkownika, tylko powiadamiają inny serwer o zmianach w kalendarzu.

Więcej informacji o powiadomieniach w Kalendarzu Google znajdziesz w artykule Modyfikowanie powiadomień Kalendarza Google.

Przypomnienia

Przypomnienie składa się z:

  • Kiedy przypomnienie ma się wyświetlać (wyrażone w postaci minut przed godziną rozpoczęcia wydarzenia)
  • Metoda wyświetlania (patrz Mechanizmy wyświetlania).

Przypomnienia możesz ustawiać dla całych kalendarzy lub poszczególnych wydarzeń. Użytkownicy mogą ustawiać domyślne przypomnienia dla każdego ze swoich kalendarzy. Są one stosowane do wszystkich wydarzeń w danym kalendarzu. Użytkownicy mogą też zastąpić te wartości domyślne w przypadku poszczególnych wydarzeń, zastępując je innym zestawem przypomnień.

Przypomnienia domyślne

Przypomnienia to prywatne informacje dotyczące uwierzytelnionego użytkownika. Nie są one udostępniane wielu użytkownikom. W efekcie:

  • Domyślne przypomnienia są obsługiwane za pomocą kolekcji KalendarzList, która zawiera metadane kalendarza dla poszczególnych użytkowników
  • Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadane udostępniane wszystkim użytkownikom.

Przypomnienia domyślne są również zwracane podczas wykonywania zapytania dotyczącego listy zdarzeń.

Zastępowanie przypomnień domyślnych

Aby zastąpić domyślne przypomnienia po wstawieniu lub edytowaniu wydarzenia, ustaw wartość reminders.useDefault na false i uzupełnij pole reminders.overrides nowym ustawieniem.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Aby przywrócić domyślny zestaw przypomnień, zmień ustawienie aktualizacji reminders.useDefault z powrotem na true.

Powiadomienia

Kalendarz obsługuje następujące typy powiadomień:

  • Tworzenie wydarzenia: nowe wydarzenie zostaje dodane do jednego z kalendarzy użytkownika.
  • Zmiana wydarzenia: organizator zmodyfikował wydarzenie, na które został zaproszony użytkownik.
  • Anulowanie wydarzenia: wydarzenie zostało anulowane, na które został zaproszony użytkownik.
  • Odpowiedź uczestnika: uczestnik wydarzenia utworzonego przez użytkownika zmienił swój stan odpowiedzi.
  • Plan dnia: lista wszystkich wydarzeń w kalendarzu użytkownika, wysłana na początku dnia.

Użytkownik może decydować, które powiadomienia włączyć w poszczególnych kalendarzach, oraz wybrać metodę dostarczania poszczególnych typów powiadomień. Nie są one udostępniane innym użytkownikom. Podobnie jak domyślne przypomnienia, są one dostępne w kolekcji CalendarList.

Aby wysyłać do uczestników e-maile z powiadomieniami o wydarzeniach wstawionych lub zaktualizowanych przy użyciu interfejsu API, ustaw parametr sendNotifications w żądaniu Insert/update na „true” (prawda).

Mechanizmy dostarczania

Metody dostarczania dostępne w Kalendarzu Google:

  • Wyskakujące okienko. Są one obsługiwane na platformach mobilnych i klientach internetowych.
  • E-mail wysłany przez serwer.

W tabeli poniżej znajdziesz obsługiwane metody w przypadku poszczególnych rodzajów przypomnień i powiadomień:

Pop-up Wyślij e-mailem
Przypomnienia Przypomnienia domyślne ✓ ✓
Zastąp przypomnienia ✓ ✓
Powiadomienia Utworzenie zdarzenia ❌ ✓
Zmiana wydarzenia ❌ ✓
Anulowanie wydarzenia ❌ ✓
Odpowiedź uczestnika ❌ ✓
Plan prezentacji ❌ ✓