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, một tin nhắn 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ề các tính năng nhắn tin có sẵn cho API Chat, hãy xem phần Tổng quan về tin nhắn trên Google Chat.
Điều kiện tiên quyết
Node.js
- 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 Node.js.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho ứ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. Để 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
- 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 Google Cloud cho Python.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho ứ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. Để 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.
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 Google Cloud cho Java.
-
Tạo thông tin xác thực mã ứng dụng khách OAuth cho ứ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. Để 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.
Apps Script
- 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.
- Tạo một dự án Apps Script độc lập và bật Dịch vụ trò chuyện nâng cao.
- 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. Để 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.
Liệt kê thư
Để liệt kê các thông báo có quy trình xác thực người dùng, hãy truyền những thông tin 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 từ trường name
của không gian. 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 đã 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 giao diện REST/HTTP, phản hồi sẽ chứa một đối tượng JSON trống, {}
.
Chủ đề có liên quan
- Định dạng thư.
- Xoá tin nhắn.
- Xem thông tin chi tiết về một tin nhắn.
- Cập nhật thông báo.
- Gửi tin nhắn.