Ein Google Chat App-Interaktionsereignis, das Daten zur Interaktion eines Nutzers mit einer Chat-App darstellt und enthält. Informationen dazu, wie Sie die Chat-App für den Empfang von Interaktionsereignissen konfigurieren, finden Sie unter Nutzerinteraktionen empfangen und beantworten.
Chat-Apps können nicht nur Ereignisse aus Nutzerinteraktionen empfangen, sondern auch Ereignisse zu Änderungen in Gruppenbereichen, z. B. wenn einem Gruppenbereich ein neues Mitglied hinzugefügt wird. Weitere Informationen zu Ereignissen im Gruppenbereich finden Sie unter Mit Terminen aus Google Chat arbeiten.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type |
Der Typ der Nutzerinteraktion mit der Chat-App, z. B. |
eventTime |
Der Zeitstempel, der angibt, wann das Interaktionsereignis eingetreten ist. |
token |
Ein Secret-Wert, mit dem in alten Chat-Apps geprüft werden kann, ob eine Anfrage von Google stammt. Google generiert das Token nach dem Zufallsprinzip und sein Wert bleibt statisch. Sie können das Token in der Google Cloud Console auf der Konfigurationsseite der Chat API abrufen, widerrufen oder neu generieren. Moderne Chat-Apps verwenden dieses Feld nicht. Er fehlt in API-Antworten und auf der Konfigurationsseite der Chat API. |
threadKey |
Der von der Chat-App definierte Schlüssel für den Thread, der sich auf das Interaktionsereignis bezieht. Weitere Informationen finden Sie unter |
message |
Die Nachricht, die das Interaktionsereignis ausgelöst hat (falls zutreffend). |
user |
Der Nutzer, der mit der Chat-App interagiert hat. |
space |
Der Gruppenbereich, in dem der Nutzer mit der Chat-App interagiert hat. |
action |
Bei |
configCompleteRedirectUrl |
Für |
isDialogEvent |
Gibt bei Interaktionsereignissen vom Typ |
dialogEventType |
Der Typ des empfangenen Interaktionsereignisses dialog. |
common |
Stellt Informationen zum Client des Nutzers dar, z. B. Sprache, Host-App und Plattform. Bei Chat-Apps enthält |
CommonEventObject
Stellt Informationen zum Client des Nutzers dar, z. B. Sprache, Host-App und Plattform. Bei Chat-Apps enthält CommonEventObject
Daten, die von Nutzern gesendet wurden, die mit Karten interagieren, z. B. Daten, die in Dialogfeldern eingegeben werden.
JSON-Darstellung |
---|
{ "userLocale": string, "hostApp": enum ( |
Felder | |
---|---|
userLocale |
Die vollständige |
hostApp |
Die hostApp-Enum, die die App angibt, aus der das Add-on aufgerufen wird. Immer |
platform |
Die Plattform-Enum, die die Plattform angibt, von der das Ereignis stammt ( |
timeZone |
Die Zeitzonen-ID und der Versatz zur koordinierten Weltzeit (UTC). Wird nur für die Ereignistypen |
formInputs |
Eine Zuordnung mit den Werten, die ein Nutzer über eine Karte oder ein Dialogfeld in ein Widget eingibt. Die Zuordnungsschlüssel sind die String-IDs, die den einzelnen Widgets zugewiesen sind, und die Werte stellen Eingaben für das Widget dar. Weitere Informationen finden Sie unter Von Nutzern eingegebene Informationen verarbeiten. |
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 der Versatz zur 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 Zeitzonencode der IANA TZ, z. B. „America/Toronto“. |
offset |
Die Zeitzonenverschiebung des Nutzers in Millisekunden gegenüber der koordinierten Weltzeit (UTC). |
Eingaben
Datentypen, die Nutzer auf Karten oder in 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 das Widget nur einen Wert akzeptiert, z. B. ein |
dateTimeInput |
Eingabewerte für Datum und Uhrzeit aus einem |
dateInput |
Eingabewerte für Datum aus einem |
timeInput |
Zeiteingabewerte aus einem |
StringInputs
Eingabeparameter für normale Widgets. Bei einwertigen Widgets handelt es sich um eine einzelne Werteliste. Bei Widgets mit mehreren Werten wie z. B. Kästchen werden alle Werte angezeigt.
JSON-Darstellung |
---|
{ "value": [ string ] } |
Felder | |
---|---|
value[] |
Eine Liste der vom Nutzer eingegebenen Strings. |
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
Eingabewerte für Datum.
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. |