Event

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

기존 채팅 앱에서 Google에서 보낸 요청인지 확인하는 데 사용할 수 있는 비밀번호 값입니다. Google에서 무작위로 토큰을 생성하고 값은 그대로 유지됩니다. Google Cloud Console의 Chat API 구성 페이지에서 토큰을 가져오거나, 취소하거나, 다시 생성할 수 있습니다.

최신 채팅 앱은 이 필드를 사용하지 않습니다. 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

사용자가 Google Chat 외부의 승인 또는 구성 흐름을 완료하면 Chat 앱에서 사용자를 리디렉션하는 URL입니다. 자세한 내용은 다른 앱 및 도구와 Chat 앱 연결하기를 참고하세요.
isDialogEvent

boolean

CARD_CLICKED 상호작용 이벤트의 경우 사용자가 대화상자와 상호작용했는지 여부
dialogEventType

enum (DialogEventType)

수신된 대화상자 상호작용 이벤트의 유형입니다.
common

object (CommonEventObject)

언어, 호스트 앱, 플랫폼과 같은 사용자 클라이언트에 대한 정보를 나타냅니다. Chat 앱의 경우 CommonEventObject에는 카드에 입력한 데이터와 같이 대화상자와 상호작용하는 사용자가 제출한 정보가 포함됩니다.

CommonEventObject

언어, 호스트 앱, 플랫폼과 같은 사용자 클라이언트에 대한 정보를 나타냅니다. Chat 앱의 경우 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 enum입니다. Chat 앱의 경우 항상 CHAT입니다.
platform

enum (Platform)

이벤트가 시작되는 플랫폼 (WEB, IOS 또는 ANDROID)을 나타내는 플랫폼 enum입니다. Chat 앱에서는 지원되지 않습니다.
timeZone

object (TimeZone)

협정 세계시 (UTC) 기준의 시간대 ID 및 오프셋입니다. CARD_CLICKED 및 SUBMIT_DIALOG 이벤트 유형에만 지원됩니다.
formInputs

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

카드에 있는 현재 위젯 값이 포함된 지도 맵 키는 각 위젯에 할당된 문자열 ID이며 값은 위젯의 입력을 나타냅니다. 입력 데이터 유형에 따라 각 입력이 다른 객체(단일 값 위젯의 경우 StringInput)를 나타냅니다. 다중 값 위젯의 경우 StringInput 객체의 배열. 날짜-시간 선택 도구의 경우 DateTimeInput. 날짜 전용 선택 도구의 경우 DateInput. 시간 전용 선택 도구의 경우 TimeInput. 대화상자의 카드에서 사용자가 입력한 데이터와 일치합니다.
parameters

map (key: string, value: string)

호출된 함수에 전달되는 맞춤 매개변수입니다. 키와 값은 모두 문자열이어야 합니다.
invokedFunction

string

위젯과 관련하여 호출된 함수의 이름입니다. Chat 앱에만 설정됩니다.

TimeZone

협정 세계시 (UTC) 기준의 시간대 ID 및 오프셋입니다. 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)

일반 위젯의 입력 매개변수입니다. 단일 값 위젯의 경우 단일 값 목록입니다. 다중 값 위젯(예: 체크박스)의 경우 모든 값이 표시됩니다.
dateTimeInput

object (DateTimeInput)

날짜 및 시간 입력 값입니다.
dateInput

object (DateInput)

날짜 입력 값입니다.
timeInput

object (TimeInput)

시간 입력 값입니다.

문자열 입력

일반 위젯의 입력 매개변수입니다. 단일 값 위젯의 경우 단일 값 목록입니다. 다중 값 위젯(예: 체크박스)의 경우 모든 값이 표시됩니다.

JSON 표현 
{
  "value": [
    string
  ]
}
필드
value[]

string

사용자가 입력한 문자열 배열.

DateTimeInput

날짜 및 시간 입력 값입니다.

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

1시간을 초과하는 분입니다. 유효한 값은 0~59입니다.