Hướng dẫn này giải thích cách sử dụng phương thức list()
trên tài nguyên Message
của API Google Chat để xem danh sách tin nhắn được phân trang và có thể lọc trong một không gian.
Trong API Chat, tin nhắn trong Chat được biểu thị bằng
Tài nguyên Message
.
Mặc dù người dùng ứng dụng Chat chỉ có thể gửi tin nhắn chứa văn bản, nhưng ứng dụng Chat có thể sử dụng nhiều tính năng nhắn tin khác, bao gồm cả việc hiển thị giao diện người dùng tĩnh hoặc tương tác, thu thập thông tin từ người dùng và phân phối tin nhắn một cách riêng tư. Để tìm hiểu thêm về tính năng nhắn tin
các tính năng có sẵn cho API Chat, hãy xem
Tổng quan về tin nhắn trong Google Chat.
Điều kiện tiên quyết
Node.js
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
- Cài đặt Thư viện ứng dụng đám mây Node.js.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho một ứng dụng dành cho máy tính. Để chạy mẫu trong hướng dẫn này, hãy lưu thông tin xác thực dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục cục bộ.
- Chọn phạm vi uỷ quyền hỗ trợ xác thực người dùng.
- Một phòng Google Chat. Để tạo cuộc trò chuyện bằng API Google Chat, hãy xem Tạo không gian. Để tạo một kênh trong Chat, hãy truy cập vào tài liệu trong Trung tâm trợ giúp.
Python
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo một dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
- Cài đặt Python Cloud Client Library.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho một ứng dụng dành cho máy tính. Để chạy mẫu trong hướng dẫn này, hãy lưu thông tin xác thực dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục cục bộ.
- Chọn phạm vi uỷ quyền hỗ trợ xác thực người dùng.
- Một phòng Google Chat. Để tạo không gian bằng API Google Chat, hãy xem phần Tạo không gian. Cách tạo cuộc trò chuyện trong Chat: hãy truy cập vào Tài liệu trong Trung tâm trợ giúp.
Java
- Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
- Cài đặt Thư viện ứng dụng đám mây Java.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho một ứng dụng dành cho máy tính. Để chạy mẫu trong hướng dẫn này, hãy lưu thông tin xác thực dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục cục bộ.
- Chọn phạm vi uỷ quyền có hỗ trợ việc xác thực người dùng.
- Một phòng Google Chat. Để tạo không gian bằng API Google Chat, hãy xem phần Tạo không gian. Cách tạo cuộc trò chuyện trong Chat: hãy truy cập vào Tài liệu trong Trung tâm trợ giúp.
Apps Script
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
- Tạo một dự án Apps Script độc lập, rồi bật Dịch vụ trò chuyện nâng cao.
- Chọn phạm vi uỷ quyền có hỗ trợ việc xác thực người dùng.
- Một phòng Google Chat. Để tạo không gian bằng API Google Chat, hãy xem phần Tạo không gian. Cách tạo cuộc trò chuyện trong Chat: hãy truy cập vào Tài liệu trong Trung tâm trợ giúp.
Liệt kê tin nhắn
Để liệt kê thông báo bằng xác thực người dùng, chuyển nội dung sau vào yêu cầu của bạn:
- Chỉ định phạm vi uỷ quyền
chat.messages.readonly
hoặcchat.messages
. - Gọi phương thức
ListMessages()
.
Ví dụ sau đây liệt kê các tin nhắn trong một phòng Chat:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế SPACE_NAME
bằng mã nhận dạng trong
của không gian
name
. Bạn có thể lấy mã nhận dạng bằng cách gọi phương thức ListSpaces()
hoặc từ URL của không gian.
Chat API trả về một danh sách tin nhắn được gửi trong không gian được chỉ định. Nếu không có thông báo nào từ yêu cầu, phản hồi Chat API sẽ trả về một đối tượng trống. Khi sử dụng REST/HTTP
giao diện, phản hồi chứa đối tượng JSON trống là {}
.