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