- 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 应用互动事件,表示并包含有关用户与 Chat 应用互动的数据。要将您的 Chat 应用配置为接收互动事件,请参阅接收和响应用户互动。
除了接收来自用户互动的事件外,Chat 应用还可以接收与聊天室更改相关的事件,例如聊天室中新增了成员时。要了解聊天室活动,请参阅处理 Google Chat 中的活动。
JSON 表示法 |
---|
{ "type": enum ( |
字段 | |
---|---|
type |
用户与 Chat 应用的互动类型,例如 |
eventTime |
指明互动事件发生时间的时间戳。 |
token |
旧版 Chat 应用可用于验证请求是否来自 Google 的密钥值。Google 会随机生成令牌,并且其值保持静态。您可以在 Google Cloud 控制台的 Chat API 配置页面获取、撤消或重新生成令牌。 现代 Chat 应用不使用此字段。API 响应和 Chat API 配置页面中不会显示此信息。 |
threadKey |
Chat 应用定义的与互动事件相关的线程的键。如需了解详情,请参阅 |
message |
对于 |
user |
与 Chat 应用互动的用户。 |
space |
用户与 Chat 应用互动时所在的聊天室。 |
action |
对于 |
configCompleteRedirectUrl |
对于 |
isDialogEvent |
对于 |
dialogEventType |
收到的 dialog 互动事件的类型。 |
common |
表示有关用户客户端的信息,例如语言区域、托管应用和平台。对于 Chat 应用, |
CommonEventObject
表示有关用户客户端的信息,例如语言区域、托管应用和平台。对于 Chat 应用,CommonEventObject
会包含与卡片互动的用户提交的数据,例如在对话框中输入的数据。
JSON 表示法 |
---|
{ "userLocale": string, "hostApp": enum ( |
字段 | |
---|---|
userLocale |
完整的 |
hostApp |
hostApp 枚举,指示从中调用插件的应用。对于 Chat 应用,始终 |
platform |
表示事件发起平台的平台枚举( |
timeZone |
时区 ID 和相对于世界协调时间 (UTC) 的偏移量。仅支持 |
formInputs |
包含用户从卡片或对话框在 widget 中输入的值的映射。映射键是分配给每个微件的字符串 ID,值表示微件的输入。 有关详情,请参阅处理用户输入的信息。 |
parameters |
传递给调用的函数的自定义参数。键和值都必须是字符串。 |
invokedFunction |
与 widget 关联的已调用函数的名称。此设置仅适用于 Chat 扩展应用。 |
TimeZone
时区 ID 和相对于世界协调时间 (UTC) 的偏移量。仅支持 CARD_CLICKED
和 SUBMIT_DIALOG
事件类型。
JSON 表示法 |
---|
{ "id": string, "offset": integer } |
字段 | |
---|---|
id |
IANA TZ 时区数据库代码,例如“America/Toronto”。 |
offset |
用户时区相对于世界协调时间 (UTC) 的偏移量(以毫秒为单位)。 |
输入
用户可在卡片或对话框中输入的数据类型。输入类型取决于 widget 接受的值的类型。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段
|
|
stringInputs |
一个字符串列表,表示用户在 widget 中输入的值。 如果该 widget 仅接受一个值,例如 |
dateTimeInput |
来自接受日期和时间的 |
dateInput |
来自仅接受日期值的 |
timeInput |
来自仅接受时间值的 |
StringInputs
常规 widget 的输入参数。对于单值 widget,则是一个单值列表。对于多值微件(例如复选框),系统将显示所有值。
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。 |