사용자와 채팅 앱의 상호작용에 관한 데이터를 나타내고 포함하는 Google Chat 앱 상호작용 이벤트입니다. 상호작용 이벤트를 수신하도록 채팅 앱을 구성하려면 사용자 상호작용 수신 및 응답을 참고하세요.
Chat 앱은 사용자 상호작용에서 이벤트를 수신하는 것 외에도 스페이스 변경사항에 관한 이벤트(예: 스페이스에 새 회원이 추가되는 경우)를 수신할 수 있습니다. 스페이스 이벤트에 관한 자세한 내용은 Google Chat의 이벤트 작업하기를 참고하세요.
JSON 표현 |
---|
{ "type": enum ( |
필드 | |
---|---|
type |
채팅 앱과의 사용자 상호작용 유형입니다(예: |
event |
상호작용 이벤트가 발생한 시간을 나타내는 타임스탬프입니다. |
token |
기존 Chat 앱에서 요청이 Google에서 온 것인지 확인하는 데 사용할 수 있는 보안 비밀번호 값입니다. Google은 토큰을 무작위로 생성하며 그 값은 정적으로 유지됩니다. Google Cloud 콘솔의 Chat API 구성 페이지에서 토큰을 가져오거나 취소하거나 다시 생성할 수 있습니다. 최신 Chat 앱에서는 이 필드를 사용하지 않습니다. API 응답 및 Chat API 구성 페이지에는 표시되지 않습니다. |
thread |
상호작용 이벤트와 관련된 대화목록의 채팅 앱에서 정의한 키입니다. 자세한 내용은 |
message |
|
user |
Chat 앱과 상호작용한 사용자입니다. |
space |
사용자가 Chat 앱과 상호작용한 스페이스입니다. |
action |
|
config |
|
is |
|
dialog |
수신된 대화상자 상호작용 이벤트의 유형입니다. |
common |
언어, 호스트 앱, 플랫폼과 같은 사용자의 클라이언트에 대한 정보를 나타냅니다. 채팅 앱의 경우 |
CommonEventObject
언어, 호스트 앱, 플랫폼과 같은 사용자 클라이언트에 관한 정보를 나타냅니다. Chat 앱의 경우 CommonEventObject
에는 카드와 상호작용하는 사용자가 제출한 데이터(예: 대화상자에 입력된 데이터)가 포함됩니다.
JSON 표현 |
---|
{ "userLocale": string, "hostApp": enum ( |
필드 | |
---|---|
user |
[ISO 639 언어 코드]-[ISO 3166 국가/지역 코드] 형식의 전체 |
host |
부가기능이 호출되는 앱을 나타내는 hostApp enum입니다. Chat 앱의 경우 항상 |
platform |
이벤트가 발생한 플랫폼을 나타내는 플랫폼 enum( |
time |
시간대 ID 및 협정 세계시(UTC) 기준 오프셋입니다. 이벤트 유형 |
form |
사용자가 카드 또는 대화상자의 위젯에 입력하는 값이 포함된 맵입니다. 맵 키는 각 위젯에 할당된 문자열 ID이고 값은 위젯의 입력을 나타냅니다. 자세한 내용은 사용자가 입력한 프로세스 정보를 참고하세요. |
parameters |
호출된 함수에 전달된 맞춤 매개변수입니다. 키와 값은 모두 문자열이어야 합니다. |
invoked |
위젯과 연결된 호출된 함수의 이름입니다. Chat 앱에만 설정할 수 있습니다. |
TimeZone
협정세계시 (UTC)를 기준으로 한 시간대 ID 및 오프셋입니다. 이벤트 유형 CARD_CLICKED
및 SUBMIT_DIALOG
에만 지원됩니다.
JSON 표현 |
---|
{ "id": string, "offset": integer } |
필드 | |
---|---|
id |
IANA TZ 시간대 데이터베이스 코드입니다(예: 'America/Toronto'). |
offset |
협정 세계시(UTC)를 기준으로 한 사용자 시간대 오프셋(밀리초)입니다. |
입력
사용자가 카드 또는 대화상자에 입력할 수 있는 데이터 유형입니다. 입력 유형은 위젯이 허용하는 값 유형에 따라 다릅니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드
|
|
string |
사용자가 위젯에 입력하는 값을 나타내는 문자열 목록입니다. 위젯이 하나의 값만 허용하는 경우(예: |
date |
날짜와 시간을 모두 허용하는 |
date |
날짜 값만 허용하는 |
time |
시간 값만 허용하는 |
StringInputs
일반 위젯의 입력 매개변수입니다. 단일 값 위젯의 경우 단일 값 목록입니다. 체크박스와 같은 다중 값 위젯의 경우 모든 값이 표시됩니다.
JSON 표현 |
---|
{ "value": [ string ] } |
필드 | |
---|---|
value[] |
사용자가 입력한 문자열의 목록입니다. |
DateTimeInput
날짜 및 시간 입력 값입니다.
JSON 표현 |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
필드 | |
---|---|
ms |
에포크 시간 이후의 시간(밀리초)입니다. |
has |
|
has |
|
DateInput
날짜 입력 값
JSON 표현 |
---|
{ "msSinceEpoch": string } |
필드 | |
---|---|
ms |
에포크 시간 이후 경과 시간(밀리초)입니다. |
TimeInput
시간 입력 값
JSON 표현 |
---|
{ "hours": integer, "minutes": integer } |
필드 | |
---|---|
hours |
24시간제의 시간입니다. |
minutes |
시간 이후 경과된 분입니다. 유효한 값은 0~59입니다. |