Event

Google Chat 앱 상호작용 이벤트입니다.

상호작용 이벤트에 대한 자세한 내용은 Google Chat 앱과의 상호작용 수신 및 응답을 참고하세요. 이벤트 유형 및 이벤트 페이로드에 관한 자세한 내용은 Google Chat 앱 상호작용 이벤트 유형을 참고하세요.

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 콘솔의 Chat API 구성 페이지에서 토큰을 가져오거나, 취소하거나, 다시 생성할 수 있습니다.

최신 채팅 앱에서는 이 필드를 사용하지 않습니다. API 응답 및 Chat API 구성 페이지에 표시되지 않습니다.
threadKey

string

상호작용 이벤트와 관련된 스레드의 채팅 앱 정의 키입니다. 자세한 내용은 spaces.messages.thread.threadKey를 참고하세요.
message

object (Message)

상호작용 이벤트를 트리거한 메시지입니다(해당하는 경우).
user

object (User)

상호작용 이벤트를 트리거한 사용자입니다.
space

object (Space)

상호작용 이벤트가 발생한 공간입니다.
action

object (FormAction)

CARD_CLICKED 상호작용 이벤트의 경우 사용자가 카드 또는 대화상자를 클릭할 때 연결된 양식 작업 데이터입니다. 자세한 내용은 사용자가 카드에 입력한 양식 데이터 읽기를 참고하세요.
configCompleteRedirectUrl

string

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

[ISO 639 언어 코드]-[ISO 3166 국가/지역 코드] 형식의 전체 locale.displayName입니다(예: 'en-US').
hostApp

enum (HostApp)

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

enum (Platform)

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

object (TimeZone)

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

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

사용자가 카드 또는 대화상자에서 위젯에 입력하는 값이 포함된 맵입니다. 맵 키는 각 위젯에 할당된 문자열 ID이고 값은 위젯에 대한 입력을 나타냅니다.

자세한 내용은 사용자가 입력한 정보 처리하기를 참고하세요.
parameters

map (key: string, value: string)

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

string

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

TimeZone

시간대 ID 및 협정 세계시 (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 위젯의 시간 입력 값

StringInputs

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

JSON 표현 
{
  "value": [
    string
  ]
}
입력란
value[]

string

사용자가 입력한 문자열 목록입니다.

DateTimeInput

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

JSON 표현 
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
입력란
msSinceEpoch

string (int64 format)

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

boolean

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

boolean

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

DateInput

날짜 입력 값입니다.

JSON 표현 
{
  "msSinceEpoch": string
}
입력란
msSinceEpoch

string (int64 format)

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

TimeInput

시간 입력 값입니다.

JSON 표현 
{
  "hours": integer,
  "minutes": integer
}
입력란
hours

integer

24시간제 시계상의 시간입니다.
minutes

integer

정각에서 경과한 시간(분)입니다. 유효한 값은 0~59입니다.