- Biểu diễn dưới dạng JSON
- CommonEventObject
- TimeZone
- Đầu vào
- StringInputs
- DateTimeInput
- DateInput
- Đầu vào thời gian
Một sự kiện tương tác trong ứng dụng Google Chat, đại diện và chứa dữ liệu về hoạt động tương tác của người dùng với một ứng dụng trong Chat. Để thiết lập ứng dụng Chat nhằm nhận sự kiện tương tác, hãy xem bài viết Nhận và trả lời hoạt động tương tác của người dùng.
Ngoài việc nhận sự kiện từ hoạt động tương tác của người dùng, các ứng dụng trong Chat còn có thể nhận được sự kiện về những thay đổi đối với không gian, chẳng hạn như khi một thành viên mới được thêm vào không gian. Để tìm hiểu về các sự kiện trong không gian, hãy xem bài viết Làm việc với các sự kiện từ Google Chat.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Kiểu tương tác người dùng với ứng dụng Chat, chẳng hạn như |
eventTime |
Dấu thời gian cho biết thời điểm xảy ra sự kiện tương tác. |
token |
Một giá trị bí mật mà các ứng dụng Chat cũ có thể dùng để xác minh xem một yêu cầu có đến từ Google hay không. Google tạo mã thông báo ngẫu nhiên và giá trị của mã đó vẫn giữ nguyên. Bạn có thể lấy, thu hồi hoặc tạo lại mã thông báo trên trang cấu hình Chat API trong Google Cloud Console. Các ứng dụng Chat hiện đại không sử dụng trường này. Không có phản hồi của API và trang cấu hình Chat API. |
threadKey |
Khoá do ứng dụng Chat xác định cho luồng liên quan đến sự kiện tương tác. Xem |
message |
Đối với các sự kiện tương tác |
user |
Người dùng đã tương tác với ứng dụng Chat. |
space |
Không gian mà người dùng đã tương tác với ứng dụng Chat. |
action |
Đối với các sự kiện tương tác |
configCompleteRedirectUrl |
Đối với các sự kiện tương tác |
isDialogEvent |
Đối với các sự kiện tương tác |
dialogEventType |
Loại sự kiện tương tác hộp thoại đã nhận được. |
common |
Biểu thị thông tin về ứng dụng của người dùng, chẳng hạn như ngôn ngữ, ứng dụng lưu trữ và nền tảng. Đối với các ứng dụng nhắn tin, |
CommonEventObject
Biểu thị thông tin về ứng dụng của người dùng, chẳng hạn như ngôn ngữ, ứng dụng lưu trữ và nền tảng. Đối với các ứng dụng nhắn tin, CommonEventObject
bao gồm dữ liệu do người dùng gửi khi tương tác với thẻ, chẳng hạn như dữ liệu được nhập vào hộp thoại.
Biểu diễn dưới dạng JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
Trường | |
---|---|
userLocale |
|
hostApp |
Enum hostApp cho biết ứng dụng mà tiện ích bổ sung được gọi. Luôn |
platform |
Enum của nền tảng cho biết nền tảng nơi sự kiện bắt nguồn ( |
timeZone |
Mã múi giờ và độ lệch so với Giờ phối hợp quốc tế (UTC). Chỉ hỗ trợ cho các loại sự kiện |
formInputs |
Một bản đồ chứa các giá trị mà người dùng nhập vào tiện ích từ một thẻ hoặc hộp thoại. Khoá ánh xạ là các mã nhận dạng chuỗi được gán cho mỗi tiện ích và các giá trị đại diện cho dữ liệu đầu vào cho tiện ích. Để biết thông tin chi tiết, hãy xem phần Xử lý thông tin do người dùng nhập. |
parameters |
Thông số tuỳ chỉnh được truyền đến hàm được gọi. Cả khoá và giá trị đều phải là chuỗi. |
invokedFunction |
Tên của hàm được gọi được liên kết với tiện ích. Chỉ áp dụng cho ứng dụng trong Chat. |
TimeZone
Mã múi giờ và độ lệch so với Giờ phối hợp quốc tế (UTC). Chỉ hỗ trợ cho các loại sự kiện CARD_CLICKED
và SUBMIT_DIALOG
.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "offset": integer } |
Trường | |
---|---|
id |
Mã cơ sở dữ liệu múi giờ IANA TZ, chẳng hạn như "Mỹ/Toronto". |
offset |
Mức chênh lệch múi giờ của người dùng, tính bằng mili giây, so với Giờ phối hợp quốc tế (UTC). |
Thông tin đầu vào
Các loại dữ liệu mà người dùng có thể nhập vào thẻ hoặc hộp thoại. Loại dữ liệu đầu vào phụ thuộc vào loại giá trị mà tiện ích chấp nhận.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp
|
|
stringInputs |
Danh sách chuỗi đại diện cho các giá trị mà người dùng nhập vào một tiện ích. Nếu tiện ích chỉ chấp nhận một giá trị, chẳng hạn như tiện ích |
dateTimeInput |
Giá trị nhập ngày và giờ từ tiện ích |
dateInput |
Giá trị nhập vào ngày từ tiện ích |
timeInput |
Giá trị nhập thời gian từ tiện ích |
StringInputs
Tham số đầu vào cho các tiện ích thông thường. Đối với các tiện ích một giá trị, đó là danh sách một giá trị duy nhất. Đối với tiện ích có nhiều giá trị, chẳng hạn như hộp đánh dấu, tất cả các giá trị đều được biểu thị.
Biểu diễn dưới dạng JSON |
---|
{ "value": [ string ] } |
Trường | |
---|---|
value[] |
Danh sách chuỗi do người dùng nhập. |
DateTimeInput
Giá trị nhập ngày và giờ.
Biểu diễn dưới dạng JSON |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
Trường | |
---|---|
msSinceEpoch |
Thời gian kể từ thời gian bắt đầu của hệ thống, tính bằng mili giây. |
hasDate |
Liệu mục nhập |
hasTime |
Liệu hoạt động đầu vào |
DateInput
Giá trị nhập ngày.
Biểu diễn dưới dạng JSON |
---|
{ "msSinceEpoch": string } |
Trường | |
---|---|
msSinceEpoch |
Thời gian kể từ thời gian bắt đầu của hệ thống, tính bằng mili giây. |
TimeInput
Giá trị nhập thời gian.
Biểu diễn dưới dạng JSON |
---|
{ "hours": integer, "minutes": integer } |
Trường | |
---|---|
hours |
Giờ trên đồng hồ 24 giờ. |
minutes |
Số phút vừa qua. Các giá trị hợp lệ là từ 0 đến 59. |