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.

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.
  • 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 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 E-Mail
Erinnerungen Standarderinnerungen ✓ ✓
Erinnerungen überschreiben ✓ ✓
Benachrichtigungen Ereignis erstellen ❌ ✓
Ereignisänderung ❌ ✓
Terminabsage ❌ ✓
Antwort des Teilnehmers ❌ ✓
Inhalt ❌ ✓