Hướng dẫn này giải thích cách sử dụng phương thức get()
trên tài nguyên Message
của API Google Chat để trả về thông tin chi tiết về tin nhắn văn bản hoặc thẻ.
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 Chat chỉ có thể gửi tin nhắn có chứa văn bản,
Các ứng dụng nhắn tin có thể dùng nhiều tính năng nhắn tin khác, bao gồm
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ừ
và gửi thư 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
- 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 quyền truy cập dựa trên cách bạn muốn xác thực trong yêu cầu API Google Chat:
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và 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ộ. - Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin xác thực tài khoản dịch vụ và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
.
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực là người dùng hay Ứng dụng Chat.
- Phòng Google Chat tại đó người dùng đã xác thực hoặc gọi cho ứng dụng Chat là một thành viên. Để xác thực là ứng dụng Chat, hãy thêm Ứng dụng nhắn tin với không gian.
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 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 Thư viện ứng dụng Google Cloud cho Python.
- Tạo thông tin xác thực quyền truy cập dựa trên cách bạn muốn xác thực trong yêu cầu API Google Chat:
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và 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ộ. - Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin xác thực tài khoản dịch vụ và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
.
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực dưới dạng người dùng hay ứng dụng Chat.
- Một không gian Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Java
- 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 Java.
- Tạo thông tin xác thực truy cập dựa trên cách bạn muốn xác thực trong API Google Chat
yêu cầu:
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và 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ộ. - Cách xác thực là ứng dụng Chat:
tạo tài khoản dịch vụ
thông tin xác thực và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
credentials.json
.
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực dưới dạng người dùng hay ứng dụng Chat.
- Một không gian Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
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.
- Trong hướng dẫn này, bạn phải sử dụng quy trình xác thực người dùng hoặc ứng dụng. Để xác thực là ứng dụng Chat, hãy tạo thông tin đăng nhập tài khoản dịch vụ. Để biết các bước thực hiện, hãy xem Xác thực và uỷ quyền dưới dạng Ứng dụng Google Chat.
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực là người dùng hay Ứng dụng Chat.
- Phòng Google Chat tại đó người dùng đã xác thực hoặc gọi cho ứng dụng Chat là một thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Nhận thông báo xác thực người dùng
Để xem thông tin chi tiết về tin nhắn với 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
GetMessage()
. - Đặt
name
thành tên tài nguyên của thông báo cần nhận.
Ví dụ sau đây sẽ nhận được một thông báo có quy trình xác thực người dùng:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế nội dung sau:
SPACE_NAME
: mã nhận dạng của không gianname
. Bạn có thể lấy ID bằng cách gọi hàmListSpaces()
hoặc từ URL của không gian.MESSAGE_NAME
: mã nhận dạng từname
của thông báo. Bạn có thể lấy mã nhận dạng từ nội dung phản hồi được trả về sau khi tạo một nhắn tin không đồng bộ bằng API Chat hoặc bằng tên tuỳ chỉnh gán cho thư khi tạo.
Chat API trả về một thực thể của Message
nêu chi tiết về thông báo đã chỉ định.
Nhận tin nhắn qua quy trình xác thực ứng dụng
Để xem thông tin chi tiết về tin nhắn với xác thực ứng 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.bot
. - Gọi phương thức
GetMessage()
. - Đặt
name
thành tên tài nguyên của thông báo cần nhận.
Ví dụ sau đây sẽ nhận được thông báo có quy trình xác thực ứng dụng:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế nội dung sau:
SPACE_NAME
: mã nhận dạng từname
của không gian. Bạn có thể lấy ID bằng cách gọi hàmListSpaces()
hoặc từ URL của không gian.MESSAGE_NAME
: mã nhận dạng từname
của thông báo. Bạn có thể lấy mã nhận dạng từ nội dung phản hồi được trả về sau khi tạo một tin nhắn không đồng bộ bằng API Chat hoặc bằng tên tuỳ chỉnh được chỉ định cho tin nhắn khi tạo.
Chat API trả về một thực thể của Message
nêu chi tiết về thông báo đã chỉ định.
Chủ đề có liên quan
- Định dạng một thư.
- Xoá tin nhắn.
- Liệt kê tin nhắn trong không gian.
- Cập nhật thông báo.
- Gửi tin nhắn.