Hướng dẫn này giải thích cách sử dụng phương thức update()
trên tài nguyên Message
của API Google Chat để cập nhật tin nhắn văn bản hoặc thẻ trong một không gian. Cập nhật thông báo để thay đổi các thuộc tính của thông báo, chẳng hạn như nội dung thông báo hoặc nội dung của thẻ. Bạn cũng có thể thêm một tin nhắn văn bản vào tin nhắn thẻ hoặc thêm một thẻ vào tin nhắn văn bản.
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 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ề 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
- 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 Node.js Cloud Client Library.
- 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:
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
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
client_secrets.json
vào thư mục địa phương của bạn. - Để 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
.
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
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
- 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.
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 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:
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
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
client_secrets.json
vào thư mục địa phương của bạn. - Để 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
.
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
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
- 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.
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 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 đá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ộ. - Để 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.
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, 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, hãy xem phần 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.
Thay mặt người dùng cập nhật tin nhắn
Với tính năng xác thực người dùng, chỉ có thể cập nhật nội dung văn bản của thư.
Để cập nhật thông báo bằng thông tin xác thực người dùng, hãy truyề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
. - Gọi phương thức
UpdateMessage()
. - Truyền
message
dưới dạng một thực thể củaMessage
bằng cách sau:- Trường
name
được đặt thành thông báo cần cập nhật, trong đó có mã không gian và một mã nhận dạng thư. - Trường
text
được đặt với văn bản mới.
- Trường
- Truyền
updateMask
với giá trịtext
.
Nếu thông báo cập nhật là thông báo thẻ, thì văn bản sẽ thêm vào trước thẻ (sẽ tiếp tục hiển thị).
Sau đây là cách cập nhật thông báo hoặc thêm thông báo văn bản vào thông báo thẻ bằng tính năng 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 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 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.
API Chat trả về một phiên bản của
Message
để cho biết chi tiết về thông báo đã được cập nhật.
Cập nhật tin nhắn dưới dạng ứng dụng Chat
Với tính năng xác thực ứng dụng, cả văn bản và thẻ của tin nhắn đều có thể được cập nhật.
Để cập nhật thông báo bằng tính năng xác thực ứng 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.bot
. - Gọi phương thức
UpdateMessage()
. - Truyền
message
dưới dạng một thực thể củaMessage
bằng cách sau:- Trường
name
được đặt thành thông báo cần cập nhật, bao gồm mã không gian và mã thông báo. - Trường
text
được đặt với văn bản mới nếu cần được cập nhật. - Trường
cardsV2
được thiết lập với các thẻ mới nếu cần cập nhật các thẻ đó.
- Trường
- Truyền
updateMask
cùng danh sách các trường để cập nhật, chẳng hạn nhưtext
vàcardsV2
.
Nếu thông báo được cập nhật là thông báo thẻ và văn bản được cập nhật, thì văn bản được cập nhật sẽ được thêm vào thẻ (vẫn tiếp tục hiển thị). Nếu thông báo cập nhật là tin nhắn văn bản và thẻ được cập nhật, sau đó các thẻ được cập nhật sẽ được thêm vào văn bản (tiếp tục màn hình).
Dưới đây là cách cập nhật văn bản và thẻ của một tin nhắn bằng tính năng 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ừ phần 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 đã cập nhật.