Hướng dẫn này giải thích cách sử dụng
update
phương thức 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 tin nhắn thẻ
trong một không gian. Cập nhật tin nhắn để thay đổi các thuộc tính của tin nhắn, chẳng hạn như nội dung tin nhắn hoặc nội dung của thẻ. Bạn cũng có thể thêm tin nhắn văn bản vào trước tin nhắn thẻ hoặc thêm thẻ vào sau tin nhắn văn bản.
Trong API Chat, 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, 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à gửi tin nhắn 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
bài viết Tổng quan về tin nhắn Google Chat.
Điều kiện tiên quyết
Node.js
- 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 Node.js.
- Tạo thông tin đăng nhập để 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 với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
credentials.jsonvào thư mục cục bộ. - Để xác thực với tư cách là ứng dụng Chat,
hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json.
- Để xác thực với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth 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 với tư cách là người dùng hay ứng dụng Chat.
Python
- 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 Python.
- Tạo thông tin đăng nhập để 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 với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
credentials.jsonvào thư mục cục bộ. - Để xác thực với tư cách là ứng dụng Chat,
hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json.
- Để xác thực với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth 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 với tư cách là người dùng hay ứng dụng Chat.
Java
- 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 đăng nhập để 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 với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
credentials.jsonvào thư mục cục bộ. - Để xác thực với tư cách là ứng dụng Chat,
hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json.
- Để xác thực với tư cách là người dùng Chat,
hãy tạo thông tin đăng nhập mã ứng dụng OAuth 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 với tư cách là người dùng hay ứng dụng Chat.
Apps Script
- 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.
- Tạo một dự án Apps Script độc lập, và bật Dịch vụ Chat nâng cao.
- Trong hướng dẫn này, bạn phải sử dụng tính năng xác thực người dùng hoặc ứng dụng. Để xác thực với tư cách 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 bài viết Xác thực và uỷ quyền với tư cách là ứ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 với tư cách là người dùng hay ứng dụng Chat.
Cập nhật tin nhắn thay mặt người dùng
Khi xác thực người dùng, bạn chỉ có thể cập nhật văn bản của tin nhắn.
Để cập nhật tin nhắn bằng tính năng xác thực người dùng, hãy truyền các thông tin sau trong yêu cầu:
- Chỉ định phạm vi uỷ quyền
chat.messages. - Gọi
UpdateMessagephương thức. - Truyền
messagedưới dạng một thực thể củaMessagevới các thông tin sau:- Trường
nameđược đặt thành tin nhắn cần cập nhật, bao gồm mã không gian và mã tin nhắn. - Trường
textđược đặt bằng văn bản mới.
- Trường
- Truyền
updateMaskvới giá trịtext.
Nếu tin nhắn đã cập nhật là tin nhắn thẻ, thì văn bản sẽ được thêm vào trước các thẻ (vẫn hiển thị).
Dưới đây là cách cập nhật tin nhắn hoặc thêm tin nhắn văn bản vào trước tin nhắn 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ế các thông tin sau:
SPACE_NAME: mã nhận dạng từnamecủa không gian. Bạn có thể lấy mã nhận dạng bằng cách gọiListSpacesphương thức hoặc từ URL của không gian.MESSAGE_NAME: mã nhận dạng từ của tin nhắnname. 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 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.
API Chat trả về một thực thể của
Message
nêu chi tiết tin nhắn đã cập nhật.
Cập nhật tin nhắn với tư cách là ứng dụng Chat
Khi xác thực ứng dụng, bạn có thể cập nhật cả văn bản và thẻ của tin nhắn.
Để cập nhật tin nhắn bằng tính năng xác thực ứng dụng, hãy truyền các thông tin sau trong yêu cầu:
- Chỉ định phạm vi uỷ quyền
chat.bot. - Gọi
UpdateMessagephương thức. - Truyền
messagedưới dạng một thực thể củaMessagevới các thông tin sau:- Trường
nameđược đặt thành tin nhắn cần cập nhật, bao gồm mã không gian và mã tin nhắn. - Trường
textđược đặt bằng văn bản mới nếu cần cập nhật. - Trường
cardsV2được đặt bằng các thẻ mới nếu cần cập nhật.
- Trường
- Truyền
updateMaskvới danh sách các trường cần cập nhật, chẳng hạn nhưtextvàcardsV2.
Nếu tin nhắn đã cập nhật là tin nhắn thẻ và văn bản được cập nhật, thì văn bản đã cập nhật sẽ được thêm vào trước các thẻ (vẫn hiển thị). Nếu tin nhắn đã cập nhật là tin nhắn văn bản và thẻ được cập nhật, thì các thẻ đã cập nhật sẽ được thêm vào sau văn bản (vẫn hiển thị).
Dưới đây là cách cập nhật văn bản và thẻ của 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ế các thông tin sau:
SPACE_NAME: mã nhận dạng từnamecủa không gian. Bạn có thể lấy mã nhận dạng bằng cách gọiListSpacesphương thức hoặc từ URL của không gian.MESSAGE_NAME: mã nhận dạng từ của tin nhắnname. 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 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.
API Chat trả về một thực thể của
Message
nêu chi tiết tin nhắn đã cập nhật.
Cập nhật thẻ không đồng bộ
Trong Bản dùng trước cho nhà phát triển, bạn có thể
cập nhật thẻ trong tin nhắn không đồng bộ bằng phương thức
replaceCards. Tính năng này hữu ích khi cập nhật nội dung của thẻ mà không cần người dùng tương tác, chẳng hạn như làm mới bản xem trước đường liên kết hoặc cập nhật trạng thái của một nhiệm vụ.
Phương thức này hoạt động đối với các tin nhắn do ứng dụng tạo, bao gồm cả những tin nhắn được tạo thay mặt người dùng.
Để biết thông tin chi tiết, hãy xem bài viết Tạo và cập nhật thẻ.
Chủ đề có liên quan
- Định dạng tin nhắn.
- Xoá tin nhắn.
- Xem thông tin chi tiết về tin nhắn.
- Liệt kê tin nhắn trong một không gian.
- Gửi tin nhắn.