EventType

Typen von Interaktionsereignissen für Google Chat-Apps

Informationen zum Konfigurieren Ihrer Chat-App für den Empfang von Interaktionsereignissen finden Sie unter Nutzerinteraktionen empfangen und darauf reagieren.

Hinweis: Dieser EventType wird nur für Chat-Interaktionsereignisse verwendet. Wenn Ihre Chat-App als Google Workspace-Add‑on erstellt wurde, finden Sie weitere Informationen in der Add‑on-Dokumentation unter Chat event objects.

Enums
UNSPECIFIED Standardwert für die Enumeration. NICHT VERWENDEN.
MESSAGE

Ein Nutzer sendet eine Nachricht an die Chat-App oder ruft die Chat-App in einem Gruppenbereich auf. Beispiele für Nachrichtenereignisse:

  • Alle Nachrichten in einem Direktnachrichtenbereich mit der Chat-App.
  • Eine Nachricht in einem Gruppenbereich, in der eine Person die Chat-App mit @erwähnt oder einen ihrer Slash-Befehle verwendet.
  • Wenn Sie Linkvorschauen für Ihre Chat-App konfiguriert haben, postet ein Nutzer eine Nachricht, die einen Link enthält, der dem konfigurierten URL-Muster entspricht.
ADDED_TO_SPACE

Ein Nutzer fügt die Chat App einem Gruppenbereich hinzu oder ein Google Workspace-Administrator installiert die Chat App in Direktnachrichtenbereichen für Nutzer in seiner Organisation. Chat-Apps reagieren in der Regel auf dieses Interaktionsereignis, indem sie eine Willkommensnachricht im Gruppenbereich posten.

Wenn Administratoren Chat-Apps installieren, wird das Feld space.adminInstalled auf true gesetzt und Nutzer können sie nicht deinstallieren. Weitere Informationen zu von Administratoren installierten Chat-Apps finden Sie in der Google Workspace-Admin-Hilfe unter Marketplace-Apps in Ihrer Domain installieren.

REMOVED_FROM_SPACE

Ein Nutzer entfernt die Chat-App aus einem Gruppenbereich oder ein Google Workspace-Administrator deinstalliert die Chat-App für einen Nutzer in seiner Organisation. Chat-Apps können nicht mit Nachrichten auf dieses Ereignis reagieren, da sie bereits entfernt wurden.

Wenn Administratoren Chat-Apps deinstallieren, wird das Feld space.adminInstalled auf false gesetzt. Wenn ein Nutzer die Chat-App vor dem Administrator installiert hat, bleibt die Chat-App für den Nutzer installiert und die Chat-App empfängt kein REMOVED_FROM_SPACE-Interaktionsereignis.

CARD_CLICKED

Ein Nutzer klickt in einer Chat-App auf ein interaktives Element einer Karte oder eines Dialogfelds, z. B. auf eine Schaltfläche. Damit ein Interaktionsereignis empfangen werden kann, muss die Schaltfläche eine weitere Interaktion mit der Chat-App auslösen. Eine Chat-App empfängt beispielsweise kein CARD_CLICKED-Interaktionsereignis, wenn ein Nutzer auf eine Schaltfläche klickt, die einen Link zu einer Website öffnet. Sie empfängt jedoch Interaktionsereignisse in den folgenden Beispielen:

  • Der Nutzer klickt auf einer Karte auf eine Send feedback-Schaltfläche, wodurch ein Dialogfeld geöffnet wird, in das der Nutzer Informationen eingeben kann.
  • Der Nutzer klickt auf eine Submit-Schaltfläche, nachdem er Informationen in eine Karte oder ein Dialogfeld eingegeben hat.

Wenn ein Nutzer auf eine Schaltfläche klickt, um ein Dialogfeld zu öffnen, zu senden oder zu schließen, wird das Feld isDialogEvent des Interaktion-Ereignisses CARD_CLICKED auf true gesetzt und enthält ein DialogEventType.

WIDGET_UPDATED Ein Nutzer aktualisiert ein Widget in einer Kartenmitteilung oder einem Dialogfeld. Dieses Ereignis wird ausgelöst, wenn ein Nutzer mit einem Widget interagiert, dem eine Aktion zugeordnet ist.
APP_COMMAND Ein Nutzer verwendet einen Befehl für eine Chat-App, einschließlich Slash-Befehle und Schnellbefehle.
APP_HOME

Ein Nutzer öffnet eine Direktnachricht von einer Chat-App, die den App-Startbildschirm verwendet. Für Ereignisse dieses Typs sind nur die Felder type, user und space enthalten. Weitere Informationen finden Sie unter Startseite für eine Google Chat-App erstellen.

SUBMIT_FORM

Ein Nutzer gibt Informationen auf einer App-Startseite ein. Für Ereignisse dieses Typs sind nur die Felder type, user und space enthalten. Weitere Informationen finden Sie unter Startseite für eine Google Chat-App erstellen.