Ein Interaktionsereignis mit einer Google Chat-App.
Weitere Informationen zu Interaktionsereignissen finden Sie unter Interaktionen mit der Google Chat-App empfangen und darauf reagieren. Informationen zu Ereignistypen und z. B. Ereignisnutzlasten finden Sie unter Arten von App-Interaktionsereignissen in Google Chat.
Zusätzlich zu Ereignissen aus Nutzerinteraktionen können Chat-Apps Ereignisse zu Änderungen an Gruppenbereichen empfangen, z. B. wenn ein neues Mitglied einem Gruppenbereich hinzugefügt wird. Weitere Informationen zu Gruppenbereichen finden Sie im Hilfeartikel Mit Terminen aus Google Chat arbeiten.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type |
Die Art des Interaktionsereignisses. Weitere Informationen finden Sie im Hilfeartikel Arten von Interaktionsereignissen in Google Chat-Apps. |
eventTime |
Zeitstempel, der angibt, wann das Interaktionsereignis aufgetreten ist |
token |
Ein geheimer Wert, mit dem alte Chat-Apps prüfen können, ob eine Anfrage von Google stammt. Google generiert das Token nach dem Zufallsprinzip. Sein Wert bleibt statisch. Sie können das Token auf der Konfigurationsseite für die Chat API in der Google Cloud Console abrufen, widerrufen oder neu generieren. In modernen Chat-Apps wird dieses Feld nicht verwendet. Er fehlt in den API-Antworten und auf der Konfigurationsseite für die Chat API. |
threadKey |
Der von der Chat-App definierte Schlüssel für den Thread, der mit dem Interaktionsereignis verknüpft ist. Weitere Informationen finden Sie unter |
message |
Die Nachricht, die das Interaktionsereignis ausgelöst hat, falls zutreffend. |
user |
Nutzer, der das Interaktionsereignis ausgelöst hat |
space |
Bereich, in dem das Interaktionsereignis aufgetreten ist |
action |
Bei |
configCompleteRedirectUrl |
Die URL, an die der Nutzer von der Chat-App weitergeleitet werden soll, nachdem er eine Autorisierung oder Konfiguration außerhalb von Google Chat abgeschlossen hat. Weitere Informationen finden Sie im Hilfeartikel Chat-App mit anderen Diensten und Tools verbinden. |
isDialogEvent |
Bei |
dialogEventType |
Der Typ des empfangenen dialog-Interaktionsereignisses. |
common |
Informationen zum Client des Nutzers, z. B. Sprache, Host-App und Plattform. Bei Chat-Apps enthält |
CommonEventObject
Informationen zum Client des Nutzers, z. B. Sprache, Host-App und Plattform. Bei Chat-Apps enthält CommonEventObject
Daten von Nutzern, die mit Karten interagieren, z. B. Daten, die in Dialogfelder eingegeben werden.
JSON-Darstellung |
---|
{ "userLocale": string, "hostApp": enum ( |
Felder | |
---|---|
userLocale |
Der vollständige |
hostApp |
Die hostApp-Enum, die die App angibt, über die das Add-on aufgerufen wird Bei Chat-Apps immer |
platform |
Die Plattform-Enum, die die Plattform angibt, von der das Ereignis stammt ( |
timeZone |
Die Zeitzonen-ID und die Abweichung von der koordinierten Weltzeit (UTC). Wird nur für die Ereignistypen |
formInputs |
Eine Karte mit den Werten, die ein Nutzer auf einer Karte oder einem Dialogfeld in ein Widget eingibt. Die Kartenschlüssel sind die String-IDs, die jedem Widget zugewiesen sind, und die Werte stellen Eingaben für das Widget dar. Weitere Informationen finden Sie unter Von Nutzern eingegebene Verarbeitungsinformationen. |
parameters |
Benutzerdefinierte Parameter, die an die aufgerufene Funktion übergeben werden. Sowohl Schlüssel als auch Werte müssen Strings sein. |
invokedFunction |
Name der aufgerufenen Funktion, die mit dem Widget verknüpft ist. Nur für Chat-Apps festgelegt. |
TimeZone
Die Zeitzonen-ID und die Abweichung von der koordinierten Weltzeit (UTC). Wird nur für die Ereignistypen CARD_CLICKED
und SUBMIT_DIALOG
unterstützt.
JSON-Darstellung |
---|
{ "id": string, "offset": integer } |
Felder | |
---|---|
id |
Der Code der IANA TZ-Zeitzone, z. B. „America/Toronto“. |
offset |
Die Zeitzone des Nutzers in Millisekunden gegenüber der koordinierten Weltzeit (UTC). |
Eingaben
Datentypen, die Nutzer in Karten oder Dialogfeldern eingeben können. Der Eingabetyp hängt vom Typ der Werte ab, die das Widget akzeptiert.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld Für |
|
stringInputs |
Eine Liste von Strings, die die Werte darstellen, die der Nutzer in ein Widget eingibt. Wenn für das Widget nur ein Wert akzeptiert wird, z. B. ein |
dateTimeInput |
Eingabewerte für Datum und Uhrzeit aus einem |
dateInput |
Datumseingabewerte aus einem |
timeInput |
Zeiteingabewerte aus einem |
StringInputs
Eingabeparameter für normale Widgets. Bei einwertigen Widgets handelt es sich um eine Einzelwertliste. Bei Widgets mit mehreren Werten, z. B. „Kästchen“, werden alle Werte angezeigt.
JSON-Darstellung |
---|
{ "value": [ string ] } |
Felder | |
---|---|
value[] |
Eine Liste von Strings, die vom Nutzer eingegeben wurden. |
DateTimeInput
Eingabewerte für Datum und Uhrzeit.
JSON-Darstellung |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
Felder | |
---|---|
msSinceEpoch |
Zeit seit Epochenzeit in Millisekunden. |
hasDate |
Gibt an, ob die |
hasTime |
Gibt an, ob die |
DateInput
Datumseingabewerte.
JSON-Darstellung |
---|
{ "msSinceEpoch": string } |
Felder | |
---|---|
msSinceEpoch |
Zeit seit Epochenzeit in Millisekunden. |
TimeInput
Zeiteingabewerte.
JSON-Darstellung |
---|
{ "hours": integer, "minutes": integer } |
Felder | |
---|---|
hours |
Die Stunde im 24-Stunden-Format. |
minutes |
Die Anzahl der Minuten nach der vollen Stunde. Gültige Werte sind 0 bis 59. |