Event

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)

이벤트 유형입니다.
eventTime

string (Timestamp format)

이벤트가 발생한 시점을 나타내는 타임스탬프입니다.
token

string

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

Modern Chat 앱은 이 필드를 사용하지 않습니다. 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 외부의 승인 또는 구성 흐름을 완료한 후 채팅 앱이 사용자를 리디렉션하는 URL입니다. 자세한 내용은 Chat 앱을 다른 서비스 및 도구에 연결하기를 참고하세요.
isDialogEvent

boolean

이벤트가 대화상자와 관련된 경우 true입니다.
dialogEventType

enum (DialogEventType)

수신한 dialog 이벤트의 유형입니다.
common

object (CommonEventObject)

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

'ISO-639 언어 코드]-[ISO 3166 국가/지역 코드] 형식(예: 'en-US')의 전체 locale.displayName Chat 앱에서는 지원되지 않습니다.
hostApp

enum (HostApp)

부가기능이 호출되는 앱을 나타내는 hostApp enum입니다. 채팅 앱의 경우 항상 CHAT
platform

enum (Platform)

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

object (TimeZone)

협정 세계시 (UTC)의 시간대 ID 및 오프셋입니다.
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 및 오프셋입니다. Chat 앱에서는 지원되지 않습니다.

JSON 표현 
{
  "id": string,
  "offset": integer
}
필드
id

string

IANA TZ 시간대 데이터베이스 코드(예: '아메리카/토론토')
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)

날짜 및 시간 입력 값입니다. Chat 앱에서는 지원되지 않습니다.
dateInput

object (DateInput)

날짜 입력 값입니다. Chat 앱에서는 지원되지 않습니다.
timeInput

object (TimeInput)

시간 입력 값입니다. Chat 앱에서는 지원되지 않습니다.

문자열 입력

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

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

string

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

날짜/시간 입력

날짜 및 시간 입력 값입니다. Chat 앱에서는 지원되지 않습니다.

JSON 표현 
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
필드
msSinceEpoch

string (int64 format)

에포크 시간 이후의 시간(밀리초)입니다.
hasDate

boolean

datetime 입력에 캘린더 날짜가 포함되는지 여부입니다.
hasTime

boolean

datetime 입력에 타임스탬프가 포함되는지 여부입니다.

날짜 입력

날짜 입력 값입니다. Chat 앱에서는 지원되지 않습니다.

JSON 표현 
{
  "msSinceEpoch": string
}
필드
msSinceEpoch

string (int64 format)

에포크 시간 이후의 시간(밀리초)입니다.

시간 입력

시간 입력 값입니다. Chat 앱에서는 지원되지 않습니다.

JSON 표현 
{
  "hours": integer,
  "minutes": integer
}
필드
hours

integer

24시간제의 시
minutes

integer

시간 이후의 분 수입니다. 유효한 값은 0~59입니다.