Event

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 (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  }
}
Felder
type

enum (EventType)

Der Typ der Nutzerinteraktion mit der Chat-App, z. B. MESSAGE oder ADDED_TO_SPACE.

eventTime

string (Timestamp format)

Der Zeitstempel, der angibt, wann das Interaktionsereignis eingetreten ist.

token

string

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

string

Der von der Chat-App definierte Schlüssel für den Thread, der sich auf das Interaktionsereignis bezieht. Weitere Informationen finden Sie unter spaces.messages.thread.threadKey.

message

object (Message)

Bei den Interaktionsereignissen ADDED_TO_SPACE, CARD_CLICKED und MESSAGE die Nachricht, die das Interaktionsereignis ausgelöst hat (falls zutreffend).

user

object (User)

Der Nutzer, der mit der Chat-App interagiert hat.

space

object (Space)

Der Gruppenbereich, in dem der Nutzer mit der Chat-App interagiert hat.

action

object (FormAction)

Bei CARD_CLICKED-Interaktionsereignissen sind das die Formularaktionsdaten, die verknüpft werden, wenn ein Nutzer auf eine Karte oder ein Dialogfeld klickt. Weitere Informationen finden Sie unter Von Nutzern eingegebene Formulardaten auf Karten lesen.

configCompleteRedirectUrl

string

Für MESSAGE-Interaktionsereignisse ist dies die URL, zu der Nutzer weitergeleitet werden müssen, nachdem sie einen Autorisierungs- oder Konfigurationsvorgang außerhalb von Google Chat abgeschlossen haben. Weitere Informationen finden Sie unter Chat-App mit anderen Diensten und Tools verbinden.

isDialogEvent

boolean

Gibt bei Interaktionsereignissen vom Typ CARD_CLICKED und MESSAGE an, ob der Nutzer mit einem Dialogfeld interagiert oder damit interagiert.

dialogEventType

enum (DialogEventType)

Der Typ des empfangenen Interaktionsereignisses dialog.

common

object (CommonEventObject)

Stellt Informationen zum Client des Nutzers dar, z. B. Sprache, Host-App und Plattform. Bei Chat-Apps enthält CommonEventObject Informationen, die von Nutzern übermittelt werden, die mit Dialogfeldern interagieren, z. B. Daten auf einer Karte.

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 (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
Felder
userLocale

string

Die vollständige locale.displayName im Format [ISO 639-Sprachcode]-[ISO 3166-Länder-/Regionscode], z. B. „en-US“.

hostApp

enum (HostApp)

Die hostApp-Enum, die die App angibt, aus der das Add-on aufgerufen wird. Immer CHAT für Chat-Apps.

platform

enum (Platform)

Die Plattform-Enum, die die Plattform angibt, von der das Ereignis stammt (WEB, IOS oder ANDROID). Wird von Chat-Apps nicht unterstützt.

timeZone

object (TimeZone)

Die Zeitzonen-ID und der Versatz zur koordinierten Weltzeit (UTC). Wird nur für die Ereignistypen CARD_CLICKED und SUBMIT_DIALOG unterstützt.

formInputs

map (key: string, value: object (Inputs))

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

map (key: string, value: string)

Benutzerdefinierte Parameter, die an die aufgerufene Funktion übergeben werden. Sowohl Schlüssel als auch Werte müssen Strings sein.

invokedFunction

string

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

string

Der Zeitzonencode der IANA TZ, z. B. „America/Toronto“.

offset

integer

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 inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
Felder

Union-Feld inputs.

Für inputs ist nur einer der folgenden Werte zulässig:

stringInputs

object (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 TextInput-Widget, enthält die Liste ein Stringobjekt. Wenn das Widget mehrere Werte akzeptiert, z. B. ein SelectionInput-Widget mit Kästchen, enthält die Liste ein Stringobjekt für jeden Wert, den der Nutzer eingibt oder auswählt.

dateTimeInput

object (DateTimeInput)

Eingabewerte für Datum und Uhrzeit aus einem DateTimePicker-Widget, das sowohl ein Datum als auch eine Uhrzeit akzeptiert.

dateInput

object (DateInput)

Eingabewerte für Datum aus einem DateTimePicker-Widget, das nur Datumswerte akzeptiert.

timeInput

object (TimeInput)

Zeiteingabewerte aus einem DateTimePicker-Widget, das nur Zeitwerte akzeptiert.

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[]

string

Eine Liste der vom Nutzer eingegebenen Strings.

DateTimeInput

Eingabewerte für Datum und Uhrzeit.

JSON-Darstellung
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
Felder
msSinceEpoch

string (int64 format)

Zeit seit Epochenzeit in Millisekunden.

hasDate

boolean

Gibt an, ob die datetime-Eingabe ein Kalenderdatum enthält.

hasTime

boolean

Gibt an, ob die datetime-Eingabe einen Zeitstempel enthält.

DateInput

Eingabewerte für Datum.

JSON-Darstellung
{
  "msSinceEpoch": string
}
Felder
msSinceEpoch

string (int64 format)

Zeit seit Epochenzeit in Millisekunden.

TimeInput

Zeiteingabewerte

JSON-Darstellung
{
  "hours": integer,
  "minutes": integer
}
Felder
hours

integer

Die Stunde im 24-Stunden-Format.

minutes

integer

Die Anzahl der Minuten nach der vollen Stunde. Gültige Werte sind 0 bis 59.