Erinnerungen und Benachrichtigungen

Die Calendar API bietet Unterstützung für Erinnerungen und Benachrichtigungen.

  • Erinnerungen sind Alarme, die zu einer bestimmten Zeit vor Beginn eines Ereignisses ausgelöst werden.
  • Benachrichtigungen ermöglichen es Nutzern, sich über Änderungen an Terminen in ihrem Kalender zu informieren.

Das letzte Element sollte nicht mit Push-Benachrichtigungen verwechselt werden, die nicht an einen Nutzer gesendet werden, sondern einen anderen Server über Änderungen an einem Kalender informieren.

Weitere Informationen zu Benachrichtigungen in Google Kalender finden Sie unter Google Kalender-Benachrichtigungen ändern.

Erinnerungen

Eine Erinnerung besteht aus:

  • Wann die Erinnerung angezeigt werden soll, ausgedrückt in Minuten vor der Startzeit des Termins
  • Die zu verwendende Übermittlungsmethode (siehe Übermittlungsmechanismen)

Erinnerungen können für ganze Kalender und für einzelne Termine festgelegt werden. Nutzer können für jeden ihrer Kalender Standarderinnerungen festlegen. Diese gelten für alle Termine in diesem Kalender. Nutzer können diese Standardeinstellungen jedoch auch für einzelne Termine überschreiben und sie durch andere Erinnerungen ersetzen.

Standarderinnerungen

Erinnerungen sind private Informationen, die für einen authentifizierten Nutzer spezifisch sind. Sie werden nicht für mehrere Nutzer freigegeben. Deshalb gilt Folgendes:

  • Standarderinnerungen werden über die Sammlung „CalendarList“ geändert, die benutzerspezifische Kalendermetadaten enthält
  • Sie sind nicht über die Sammlung „Kalender“ zugänglich, die globale Metadaten enthält, die für alle Nutzer freigegeben sind.

Standarderinnerungen werden auch bei einer Abfrage der Ereignisliste zurückgegeben.

Standarderinnerungen überschreiben

Wenn Sie die Standarderinnerungen beim Einfügen oder Ändern eines Termins überschreiben möchten, setzen Sie reminders.useDefault auf false und füllen Sie reminders.overrides mit der neuen Erinnerung aus.

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

Wenn Sie zum Standardsatz von Erinnerungen zurückkehren möchten, setzen Sie die Aktualisierungseinstellung reminders.useDefault auf true zurück.

Benachrichtigungen

Google Kalender unterstützt die folgenden Benachrichtigungstypen:

  • Terminerstellung: Ein neuer Termin wird einem der Kalender des Nutzers hinzugefügt.
  • Ereignisänderung: Der Organisator hat einen Termin geändert, zu dem der Nutzer eingeladen war.
  • Terminabsage: Ein Termin wird abgesagt, zu dem der Nutzer eingeladen wurde.
  • Antwort des Teilnehmers: Ein Teilnehmer eines Termins, der vom Nutzer erstellt wurde, hat seinen Antwortstatus geändert.
  • Terminübersicht: Eine Liste aller Termine im Kalender des Nutzers, die zu Beginn des Tages gesendet wird.

Der Nutzer kann entscheiden, welche Benachrichtigungen pro Kalender aktiviert werden sollen und welche Zustellungsmethode für jeden Benachrichtigungstyp verwendet werden soll. Diese Einstellungen werden nicht mit anderen Nutzern geteilt. Ähnlich wie die Standarderinnerungen sind sie über die Sammlung "CalendarList" zugänglich.

Wenn Sie E-Mail-Benachrichtigungen für Termine an Teilnehmer senden möchten, die über die API eingefügt oder aktualisiert wurden, setzen Sie den Parameter sendNotifications in der Anfrage zum Einfügen/Aktualisieren auf "true".

Übermittlungsmechanismen

Folgende Übermittlungsmethoden werden von Google Kalender angeboten:

  • Pop-up: Diese werden von mobilen Plattformen und Webclients unterstützt.
  • Vom Server gesendete E-Mail

In der folgenden Tabelle sind die unterstützten Methoden für die einzelnen Erinnerungs- oder Benachrichtigungstypen aufgeführt:

Pop-up E-Mail
Erinnerungen Standarderinnerungen ✓ ✓
Erinnerungen überschreiben ✓ ✓
Benachrichtigungen Erstellung von Ereignissen ❌ ✓
Ereignisänderung ❌ ✓
Terminabsage ❌ ✓
Antwort des Teilnehmers ❌ ✓
Inhalt ❌ ✓