Erinnerungen und Benachrichtigungen

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

• Erinnerungen sind Alarme, die zu einem bestimmten Zeitpunkt vor Beginn eines Termins ausgelöst werden.
• Benachrichtigungen informieren Nutzer über Änderungen an Terminen in ihrem Kalender.

Verwechseln Sie Benachrichtigungen nicht mit Push-Benachrichtigungen, die einen anderen Server über Änderungen an einem Kalender informieren, anstatt an einen Nutzer gesendet zu werden.

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

Erinnerungen

Eine Erinnerung besteht aus:

• Gibt an, wie viele Minuten vor dem Beginn des Termins die Erinnerung angezeigt werden soll.
• Die zu verwendende Auslieferungsmethode (siehe Auslieferungsmechanismen).

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

Standarderinnerungen

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

• Standarderinnerungen werden über die Sammlung CalendarList bearbeitet, die nutzerspezifische Kalendermetadaten enthält.
• Sie sind nicht über die Sammlung Calendars 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 Erstellen oder Aktualisieren eines Termins überschreiben möchten, legen Sie reminders.useDefault auf false fest und füllen Sie reminders.overrides mit dem neuen Erinnerungssatz. Überschreibungen können nur festgelegt werden, wenn useDefault false ist, wie im folgenden Beispiel gezeigt:

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

Wenn Sie zum Standardset an Erinnerungen zurückkehren möchten, aktualisieren Sie die Einstellung reminders.useDefault auf true.

Benachrichtigungen

Calendar unterstützt die folgenden Benachrichtigungstypen:

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

Der Nutzer kann für jeden Kalender festlegen, welche Benachrichtigungen aktiviert werden sollen, und die Zustellungsmethode für jeden Benachrichtigungstyp auswählen. Diese Einstellungen werden nicht für andere Nutzer freigegeben. Ähnlich wie bei Standarderinnerungen können Sie über die Sammlung CalendarList darauf zugreifen.

Wenn Sie E‑Mail-Benachrichtigungen an Teilnehmer für Ereignisse senden möchten, die mit der API eingefügt oder aktualisiert wurden, rufen Sie die Methode insert oder update auf und legen Sie den Parameter sendUpdates auf "all" oder "externalOnly" fest.

Übermittlungsmechanismen

Google Kalender bietet folgende Übermittlungsmethoden:

• Pop-up Sie werden auf mobilen Plattformen und in Webclients unterstützt.
• E-Mail, die vom Server gesendet wurde.

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