- Biểu diễn dưới dạng JSON
- CommonEventObject (Đối tượng sự kiện chung)
- TimeZone
- Phương thức nhập
- StringInputs
- DateTimeInput
- DateInput
- TimeInput
Một sự kiện tương tác với ứng dụng Google Chat.
Để tìm hiểu về các sự kiện tương tác, hãy xem bài viết Nhận và phản hồi các lượt tương tác với ứng dụng Google Chat. Để tìm hiểu về các loại sự kiện và ví dụ về tải trọng sự kiện, hãy xem bài viết Các loại sự kiện tương tác với ứng dụng Google Chat.
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ó 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 trên Google Chat.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Loại sự kiện tương tác. Để biết thông tin chi tiết, hãy xem bài viết Các loại sự kiện tương tác với ứng dụng Google Chat. |
eventTime |
Dấu thời gian cho biết thời điểm xảy ra sự kiện tương tác. |
token |
Giá trị bí mật mà các ứng dụng Chat cũ có thể sử dụng để xác minh xem một yêu cầu có phải là của Google hay không. Google tạo mã thông báo ngẫu nhiên và giá trị của mã vẫn không thay đổi. 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 API Chat trong Google Cloud Console. Các ứng dụng Chat hiện đại không sử dụng trường này. Tính năng này không có trong tính năng phản hồi của API và trang cấu hình của API Chat. |
threadKey |
Khoá do ứng dụng Chat xác định cho chuỗi liên quan đến sự kiện tương tác. Xem |
message |
Thông báo đã kích hoạt sự kiện tương tác, nếu có. |
user |
Người dùng đã kích hoạt sự kiện tương tác. |
space |
Không gian xảy ra sự kiện tương tác. |
action |
Đối với sự kiện tương tác |
configCompleteRedirectUrl |
URL mà ứng dụng Chat phải chuyển hướng người dùng đến sau khi họ hoàn tất quy trình uỷ quyền hoặc định cấu hình bên ngoài Google Chat. Để biết thêm thông tin, hãy xem bài viết Kết nối một ứng dụng trong Chat với các dịch vụ và công cụ khá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 trong Chat, |
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 trong Chat, CommonEventObject
bao gồm dữ liệu do người dùng tương tác với thẻ gửi, 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 qua đó. Luôn |
platform |
Enum nền tảng cho biết nền tảng nơi sự kiện bắt đầu ( |
timeZone |
Mã múi giờ và chênh lệch so với Múi giờ phối hợp quốc tế (UTC). Chỉ hỗ trợ cho các loại sự kiện |
formInputs |
Bản đồ chứa các giá trị mà người dùng nhập vào tiện ích từ thẻ hoặc hộp thoại. Khoá ánh xạ là mã nhận dạng chuỗi được chỉ định cho mỗi tiện ích và các giá trị này đạ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 bài viết 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 liên kết với tiện ích. Chỉ dành cho các ứng dụng trong Chat. |
TimeZone
Mã múi giờ và chênh lệch so với Mú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ư "America/Toronto". |
offset |
Chênh lệch múi giờ của người dùng (tính bằng mili giây) tính theo Mú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 trên 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 hợp
|
|
stringInputs |
Danh sách chuỗi đại diện cho những giá trị mà người dùng nhập vào trong 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 |
Nhập giá trị ngày và giờ qua tiện ích |
dateInput |
Nhập các giá trị ngày qua tiện ích |
timeInput |
Giá trị nhập vào thời gian qua tiện ích |
StringInputs
Tham số nhập cho các tiện ích thông thường. Đối với các tiện ích có một giá trị, đây là danh sách giá trị duy nhất. Đối với các tiện ích có nhiều giá trị, chẳng hạn như hộp đánh dấu, tất cả giá trị đều được trình bày.
Biểu diễn dưới dạng JSON |
---|
{ "value": [ string ] } |
Trường | |
---|---|
value[] |
Danh sách các 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 đầ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 vào theo 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 quá giờ. Các giá trị hợp lệ là từ 0 đến 59. |