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.
• Mit Benachrichtigungen werden Nutzer über Änderungen an Terminen in ihrem Kalender informiert.

Letzteres sollte nicht mit Push-Benachrichtigungen verwechselt werden. Diese werden 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 dem Beginn des Termins
• Die zu verwendende Übermittlungsmethode (siehe Übermittlungsmechanismen)

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

Standarderinnerungen

Erinnerungen sind private Informationen, die für einen authentifizierten Nutzer spezifisch sind. Sie werden nicht mit mehreren Nutzern geteilt. Deshalb gilt Folgendes:

• Standarderinnerungen werden über die CalendarList-Sammlung bearbeitet, die nutzerspezifische Kalendermetadaten enthält.
• Sie sind nicht über die Kalendersammlung zugänglich, die globale Metadaten enthält, die für alle Nutzer freigegeben werden.

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 Standarderinnerungen wiederherstellen möchten, setzen Sie reminders.useDefault auf true zurück.

Benachrichtigungen

Google Kalender unterstützt die folgenden Benachrichtigungstypen:

• Terminerstellung: Einem 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 von Veranstaltungen: Ein Termin wird abgesagt, zu dem der Nutzer eingeladen wurde.
• Antwort des Teilnehmers: Ein Gast eines Termins, der vom Nutzer erstellt wurde, hat seinen Antwortstatus geändert.
• Agenda: Eine Liste aller Termine im Kalender des Nutzers, die zu Beginn 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 mit anderen Nutzern geteilt. Ähnlich wie Standarderinnerungen sind sie über die Sammlung „CalendarList“ zugänglich.

Wenn Sie E-Mail-Benachrichtigungen über Ereignisse 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

Google Kalender bietet folgende Übermittlungsmethoden:

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

Die folgende Tabelle zeigt die unterstützten Methoden für die einzelnen Erinnerungs- oder Benachrichtigungstypen:

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