Erinnerungen und Benachrichtigungen

Die Calendar API unterstützt Erinnerungen und Benachrichtigungen.

• Erinnerungen sind Wecker, 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 bei einer Abfrage der Ereignisliste zurückgegeben.

Standarderinnerungen überschreiben

Wenn Sie die Standarderinnerungen überschreiben möchten, wenn Sie ein Ereignis einfügen oder ändern, legen Sie reminders.useDefault auf false fest und füllen Sie reminders.overrides mit dem neuen Erinnerungssatz aus.

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

Wenn Sie zu den Standarderinnerungen zurückkehren möchten, aktualisieren Sie die Einstellung reminders.useDefault auf true.

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.
• Terminabsagen: Ein Termin, zu dem der Nutzer eingeladen wurde, wird abgesagt.
• Teilnehmerantwort: Ein Teilnehmer an einem vom Nutzer erstellten Termin hat seinen Antwortstatus geändert.
• Agenda: Eine Liste aller Termine im Kalender des Nutzers, die am Anfang des Tages gesendet wird.

Der Nutzer kann festlegen, welche Benachrichtigungen für jeden Kalender aktiviert werden sollen, und die Zustellungsmethode für jeden Benachrichtigungstyp. 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“.

Auslieferungsmechanismen

Die von Google Kalender angebotenen Übermittlungsmethoden:

• Pop-up Sie werden auf Mobilplattformen und 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: