Event

Событие взаимодействия с приложением Google Chat.

Дополнительную информацию о событиях взаимодействия см. в разделе Получение и ответ на взаимодействие с приложением Google Chat . Дополнительные сведения о типах событий и, например, о полезных нагрузках событий см. в разделе Типы событий взаимодействия с приложением Google Chat .

Помимо получения событий от взаимодействия с пользователем, приложения чата могут получать события об изменениях в пространствах, например, когда в пространство добавляется новый участник. Дополнительную информацию о космических мероприятиях см. в разделе Работа с мероприятиями из Google Chat .

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)
  }
}
Поля
type

enum ( EventType )

Тип события взаимодействия. Подробную информацию см. в разделе Типы событий взаимодействия с приложением Google Chat .

eventTime

string ( Timestamp format)

Временная метка, указывающая, когда произошло событие взаимодействия.

token

string

Секретное значение, которое устаревшие приложения Chat могут использовать для проверки того, поступил ли запрос от Google. Google генерирует токен случайным образом, и его значение остается неизменным. Вы можете получить, отозвать или восстановить токен на странице конфигурации Chat API в Google Cloud Console.

Современные приложения чата не используют это поле. Он отсутствует в ответах API и на странице конфигурации Chat API .

threadKey

string

Ключ, определенный приложением Chat для цепочки, связанной с событием взаимодействия. Дополнительную информацию см. в spaces.messages.thread.threadKey .

message

object ( Message )

Сообщение, которое инициировало событие взаимодействия, если применимо.

user

object ( User )

Пользователь, который инициировал событие взаимодействия.

space

object ( Space )

Пространство, в котором произошло событие взаимодействия.

action

object ( FormAction )

Для событий взаимодействия CARD_CLICKED — данные действия формы, связанные с тем, что пользователь щелкает карточку или диалоговое окно. Дополнительные сведения см. в разделе Чтение данных формы, вводимых пользователями на картах .

configCompleteRedirectUrl

string

URL-адрес, на который приложение Chat должно перенаправить пользователя после завершения процесса авторизации или настройки за пределами Google Chat. Дополнительную информацию см. в разделе Подключение приложения Chat к другим службам и инструментам .

isDialogEvent

boolean

Для событий взаимодействия CARD_CLICKED — взаимодействовал ли пользователь с диалогом .

dialogEventType

enum ( DialogEventType )

Тип полученного события диалогового взаимодействия.

common

object ( CommonEventObject )

Представляет информацию о клиенте пользователя, например локаль, ведущее приложение и платформу. Для приложений чата CommonEventObject включает информацию, отправленную пользователями, взаимодействующими с диалоговыми окнами , например данные, введенные на карточке.

CommonEventObject

Представляет информацию о клиенте пользователя, например локаль, ведущее приложение и платформу. Для приложений чата CommonEventObject включает данные, отправленные пользователями, взаимодействующими с карточками, например данные, введенные в диалоговых окнах .

JSON-представление
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
Поля
userLocale

string

Полное locale.displayName в формате [код языка ISO 639]-[код страны/региона ISO 3166], например «en-US».

hostApp

enum ( HostApp )

Перечисление hostApp, указывающее приложение, из которого вызывается надстройка. Всегда CHAT для приложений чата.

platform

enum ( Platform )

Перечисление платформы, указывающее платформу, на которой происходит событие ( WEB , IOS или ANDROID ). Не поддерживается приложениями чата.

timeZone

object ( TimeZone )

Идентификатор часового пояса и смещение от всемирного координированного времени (UTC). Поддерживается только для типов событий CARD_CLICKED и SUBMIT_DIALOG .

formInputs

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

Карта, содержащая значения, которые пользователь вводит в виджет из карточки или диалогового окна. Ключи карты — это строковые идентификаторы, назначенные каждому виджету, а значения представляют собой входные данные для виджета.

Подробности см. в разделе Информация о процессе, введенная пользователями .

parameters

map (key: string, value: string)

Пользовательские параметры , передаваемые в вызванную функцию. И ключи, и значения должны быть строками.

invokedFunction

string

Имя вызванной функции, связанной с виджетом. Устанавливается только для приложений чата.

Часовой пояс

Идентификатор часового пояса и смещение от всемирного координированного времени (UTC). Поддерживается только для типов событий CARD_CLICKED и SUBMIT_DIALOG .

JSON-представление
{
  "id": string,
  "offset": integer
}
Поля
id

string

Код базы данных часовых поясов IANA TZ , например «America/Toronto».

offset

integer

Смещение часового пояса пользователя в миллисекундах от всемирного координированного времени (UTC).

Входы

Типы данных, которые пользователи могут вводить на карточках или в диалогах . Тип ввода зависит от типа значений, которые принимает виджет.

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.
}
Поля

inputs поля объединения.

inputs могут быть только одним из следующих:

stringInputs

object ( StringInputs )

Список строк, представляющих значения, которые пользователь вводит в виджет.

Если виджет принимает только одно значение, например виджет TextInput , список содержит один строковый объект. Если виджет принимает несколько значений, например виджет SelectionInput с флажками, список содержит строковый объект для каждого значения, которое вводит или выбирает пользователь.

dateTimeInput

object ( DateTimeInput )

Входные значения даты и времени из виджета DateTimePicker , который принимает как дату, так и время.

dateInput

object ( DateInput )

Значения ввода даты из виджета DateTimePicker , который принимает только значения даты.

timeInput

object ( TimeInput )

Входные значения времени из виджета DateTimePicker , который принимает только значения времени.

Строковые входы

Входной параметр для обычных виджетов. Для виджетов с одним значением это список с одним значением. Для виджетов с несколькими значениями, таких как флажок, представлены все значения.

JSON-представление
{
  "value": [
    string
  ]
}
Поля
value[]

string

Список строк, введенных пользователем.

ДатаВремяИнпут

Входные значения даты и времени.

JSON-представление
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
Поля
msSinceEpoch

string ( int64 format)

Время, прошедшее с начала эпохи, в миллисекундах.

hasDate

boolean

Включает ли ввод datetime календарную дату.

hasTime

boolean

Включает ли ввод datetime времени метку времени.

ДатаВвод

Значения ввода даты.

JSON-представление
{
  "msSinceEpoch": string
}
Поля
msSinceEpoch

string ( int64 format)

Время, прошедшее с начала эпохи, в миллисекундах.

ТаймИнпут

Входные значения времени.

JSON-представление
{
  "hours": integer,
  "minutes": integer
}
Поля
hours

integer

Час в 24-часовом формате.

minutes

integer

Количество минут после часа. Допустимые значения: от 0 до 59.