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.
Das letztere Element sollte nicht mit push verwechselt werden. die statt zugestellt werden, 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*innen kann für alle ihre Kalender Standarderinnerungen festlegen. gelten diese Standardeinstellungen alle Termine in diesem Kalender. Nutzer können diese Einstellungen für einzelne Ereignisse festlegen, die durch einen anderen Satz Erinnerungen.
Standarderinnerungen
Erinnerungen sind private Informationen, die für einen authentifizierten Nutzer spezifisch sind. sie sind nicht für mehrere Nutzer freigegeben. Deshalb gilt Folgendes:
- Standarderinnerungen werden über die CalendarList-Sammlung bearbeitet, die enthält benutzerspezifische Kalendermetadaten.
- Sie sind nicht über die Kalendersammlung zugänglich, die globale Metadaten, 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, legen Sie
reminders.useDefault
auf false
und füllen Sie
reminders.overrides
mit der neuen Erinnerung.
"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, müssen Sie eine Aktualisierungseinstellung vornehmen
reminders.useDefault
Zurück zu true
.
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.
- Teilnehmerantwort: 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 wie die Benachrichtigungen zugestellt werden. für jeden Benachrichtigungstyp. Diese Einstellungen werden nicht mit anderen geteilt Nutzenden. Ähnlich wie bei den Standarderinnerungen kann auf sie über die KalenderList-Sammlung.
Um E-Mail-Benachrichtigungen an Teilnehmer zu senden, wenn Termine eingefügt oder
über die API aktualisiert haben, legen Sie den Parameter sendNotifications
in der Datei
Anfrage 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 | |||
---|---|---|---|
Erinnerungen | Standarderinnerungen | ✓ | ✓ |
Erinnerungen überschreiben | ✓ | ✓ | |
Benachrichtigungen | Ereignis erstellen | ❌ Vorstellung | ✓ |
Ereignisänderung | ❌ Vorstellung | ✓ | |
Terminabsage | ❌ Vorstellung | ✓ | |
Antwort des Teilnehmers | ❌ Vorstellung | ✓ | |
Inhalt | ❌ Vorstellung | ✓ |