Event

Peristiwa interaksi aplikasi Google Chat yang mewakili dan berisi data tentang interaksi pengguna dengan aplikasi Chat. Untuk mengonfigurasi aplikasi Chat Anda agar menerima peristiwa interaksi, lihat Menerima dan merespons interaksi pengguna.

Selain menerima peristiwa dari interaksi pengguna, aplikasi Chat dapat menerima peristiwa terkait perubahan ruang, seperti saat anggota baru ditambahkan ke ruang. Untuk mempelajari peristiwa ruang, lihat Menggunakan peristiwa dari Google Chat.

Representasi JSON
{
  "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)
  }
}
Kolom
type

enum (EventType)

Jenis interaksi pengguna dengan aplikasi Chat, seperti MESSAGE atau ADDED_TO_SPACE.

eventTime

string (Timestamp format)

Stempel waktu yang menunjukkan kapan peristiwa interaksi terjadi.

token

string

Nilai rahasia yang dapat digunakan aplikasi Chat lama untuk memverifikasi apakah permintaan berasal dari Google. Google membuat token secara acak, dan nilainya tetap statis. Anda dapat memperoleh, mencabut, atau membuat ulang token dari halaman konfigurasi Chat API di Konsol Google Cloud.

Aplikasi Chat modern tidak menggunakan kolom ini. API ini tidak ada dalam respons API dan halaman konfigurasi Chat API.

threadKey

string

Kunci yang ditentukan aplikasi Chat untuk thread yang terkait dengan peristiwa interaksi. Lihat spaces.messages.thread.threadKey untuk mengetahui informasi selengkapnya.

message

object (Message)

Untuk peristiwa interaksi ADDED_TO_SPACE, CARD_CLICKED, dan MESSAGE, pesan yang memicu peristiwa interaksi, jika berlaku.

user

object (User)

Pengguna yang berinteraksi dengan aplikasi Chat.

space

object (Space)

Ruang tempat pengguna berinteraksi dengan aplikasi Chat.

action

object (FormAction)

Untuk peristiwa interaksi CARD_CLICKED, data tindakan formulir yang terkait saat pengguna mengklik kartu atau dialog. Untuk mempelajari lebih lanjut, lihat Membaca input data formulir oleh pengguna di kartu.

configCompleteRedirectUrl

string

Untuk peristiwa interaksi MESSAGE, URL tujuan pengalihan pengguna setelah mereka menyelesaikan alur otorisasi atau konfigurasi di luar Google Chat. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan aplikasi Chat dengan layanan dan alat lainnya.

isDialogEvent

boolean

Untuk peristiwa interaksi CARD_CLICKED dan MESSAGE, baik pengguna sedang berinteraksi atau akan berinteraksi dengan dialog.

dialogEventType

enum (DialogEventType)

Jenis peristiwa interaksi dialog yang diterima.

common

object (CommonEventObject)

Menampilkan informasi tentang klien pengguna, seperti lokalitas, aplikasi host, dan platform. Untuk aplikasi Chat, CommonEventObject menyertakan informasi yang dikirim oleh pengguna yang berinteraksi dengan dialog, seperti data yang dimasukkan di kartu.

CommonEventObject

Menampilkan informasi tentang klien pengguna, seperti lokalitas, aplikasi host, dan platform. Untuk aplikasi Chat, CommonEventObject menyertakan data yang dikirim oleh pengguna yang berinteraksi dengan kartu, seperti data yang dimasukkan dalam dialog.

Representasi JSON
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
Kolom
userLocale

string

locale.displayName lengkap dalam format [kode bahasa ISO 639]-[kode negara/wilayah ISO 3166] seperti "en-US".

hostApp

enum (HostApp)

Enum hostApp yang menunjukkan aplikasi asal add-on dipanggil. Selalu CHAT untuk aplikasi Chat.

platform

enum (Platform)

Enum platform yang menunjukkan platform tempat peristiwa berasal (WEB, IOS, atau ANDROID). Tidak didukung oleh aplikasi Chat.

timeZone

object (TimeZone)

ID zona waktu dan offset dari Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Hanya didukung untuk jenis peristiwa CARD_CLICKED dan SUBMIT_DIALOG.

formInputs

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

Peta yang berisi nilai yang dimasukkan pengguna dalam widget dari kartu atau dialog. Kunci peta adalah ID string yang ditetapkan untuk setiap widget, dan nilainya mewakili input ke widget.

Untuk mengetahui detailnya, lihat Memproses informasi yang dimasukkan oleh pengguna.

parameters

map (key: string, value: string)

Parameter kustom yang diteruskan ke fungsi yang dipanggil. Kunci dan nilai harus berupa string.

invokedFunction

string

Nama fungsi yang dipanggil yang terkait dengan widget. Hanya disetel untuk aplikasi Chat.

TimeZone

ID zona waktu dan offset dari Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Hanya didukung untuk jenis peristiwa CARD_CLICKED dan SUBMIT_DIALOG.

Representasi JSON
{
  "id": string,
  "offset": integer
}
Kolom
id

string

Kode database zona waktu IANA TZ, seperti "America/Toronto".

offset

integer

Offset zona waktu pengguna, dalam milidetik, dari Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC).

Input

Jenis data yang dapat dimasukkan oleh pengguna pada kartu atau dialog. Jenis input bergantung pada jenis nilai yang diterima widget.

Representasi JSON
{

  // 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.
}
Kolom

Kolom union inputs.

inputs hanya dapat berupa salah satu dari yang berikut:

stringInputs

object (StringInputs)

Daftar string yang mewakili nilai yang dimasukkan pengguna dalam widget.

Jika widget hanya menerima satu nilai, seperti widget TextInput, daftar akan berisi satu objek string. Jika widget menerima beberapa nilai, seperti widget SelectionInput kotak centang, daftar berisi objek string untuk setiap nilai yang dimasukkan atau dipilih pengguna.

dateTimeInput

object (DateTimeInput)

Nilai input tanggal dan waktu dari widget DateTimePicker yang menerima tanggal dan waktu.

dateInput

object (DateInput)

Nilai input tanggal dari widget DateTimePicker yang hanya menerima nilai tanggal.

timeInput

object (TimeInput)

Nilai input waktu dari widget DateTimePicker yang hanya menerima nilai waktu.

StringInputs

Parameter input untuk widget reguler. Untuk widget bernilai tunggal, ini merupakan daftar nilai tunggal. Untuk widget multi-nilai, seperti kotak centang, semua nilai akan ditampilkan.

Representasi JSON
{
  "value": [
    string
  ]
}
Kolom
value[]

string

Daftar string yang dimasukkan oleh pengguna.

DateTimeInput

Nilai input tanggal dan waktu.

Representasi JSON
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
Kolom
msSinceEpoch

string (int64 format)

Waktu sejak epoch, dalam milidetik.

hasDate

boolean

Apakah input datetime menyertakan tanggal kalender.

hasTime

boolean

Apakah input datetime menyertakan stempel waktu atau tidak.

DateInput

Nilai input tanggal.

Representasi JSON
{
  "msSinceEpoch": string
}
Kolom
msSinceEpoch

string (int64 format)

Waktu sejak epoch, dalam milidetik.

TimeInput

Nilai input waktu.

Representasi JSON
{
  "hours": integer,
  "minutes": integer
}
Kolom
hours

integer

Jam dalam format 24 jam.

minutes

integer

Jumlah menit setelah satu jam. Nilai yang valid adalah 0 hingga 59.