Erinnerungen und Benachrichtigungen

Die Calendar API unterstützt Erinnerungen und Benachrichtigungen.

  • Erinnerungen sind Alarme, die zu einer bestimmten Zeit vor Beginn eines Ereignisses ausgelöst werden.
  • Über Benachrichtigungen können Nutzer über Änderungen an Terminen in ihrem Kalender informiert werden.

Letzteres sollte nicht mit Push-Benachrichtigungen verwechselt werden, die nicht an einen Nutzer gesendet, 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, angegeben in Minuten vor Beginn der Veranstaltung
  • Die zu verwendende Auslieferungsmethode (siehe Auslieferungsmechanismen)

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 Standardeinstellungen gelten für alle Termine in diesem Kalender. Nutzer können diese Standardeinstellungen jedoch für einzelne Termine außer Kraft setzen und durch eine andere Reihe 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 „Kalender“ zugänglich, die globale Metadaten enthält, die für alle Nutzer freigegeben sind.

Standarderinnerungen werden auch zurückgegeben, wenn Sie eine Terminlistenabfrage ausführen.

Standarderinnerungen überschreiben

Wenn Sie die Standarderinnerungen beim Einfügen oder Ändern eines Termins überschreiben möchten, setzen Sie reminders.useDefault auf false und geben Sie für reminders.overrides die neuen Erinnerungssätze an.

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

Wenn Sie die Standardeinstellungen für Erinnerungen wiederherstellen möchten, setzen Sie reminders.useDefault auf true zurück.

Benachrichtigungen

Google Kalender unterstützt die folgenden Benachrichtigungstypen:

  • Termin erstellen: Einem der Kalender des Nutzers wird ein neuer Termin hinzugefügt.
  • Terminänderung: Der Organisator hat einen Termin geändert, zu dem der Nutzer eingeladen wurde.
  • Absage eines Termins: Ein Termin, zu dem der Nutzer eingeladen wurde, wird abgesagt.
  • Teilnehmerantwort: Ein Teilnehmer eines vom Nutzer erstellten Termins hat seinen Antwortstatus geändert.
  • Agenda: Eine Liste aller Termine im Kalender des Nutzers, die am Anfang des Tages gesendet wird.

Der Nutzer kann entscheiden, welche Benachrichtigungen für jeden Kalender aktiviert werden sollen und welche Zustellungsmethode für jeden Benachrichtigungstyp verwendet werden soll. Diese Einstellungen werden nicht für andere Nutzer freigegeben. Ähnlich wie bei Standarderinnerungen sind sie über die Sammlung „CalendarList“ zugänglich.

Wenn Sie E-Mail-Benachrichtigungen an Teilnehmer für Ereignisse senden möchten, die über die API eingefügt oder aktualisiert wurden, setzen Sie den Parameter sendNotifications in der Insert-/Update-Anfrage auf „true“.

Übermittlungsmechanismen

Die von Google Kalender angebotenen Übermittlungsmethoden:

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

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

Pop-up E-Mail
Erinnerungen Standarderinnerungen ✓ ✓
Erinnerungen überschreiben ✓ ✓
Benachrichtigungen Ereignis erstellen ❌ ✓
Terminänderung ❌ ✓
Termin absagen ❌ ✓
Antwort des Teilnehmers ❌ ✓
Inhalt ❌ ✓