Hướng dẫn này giải thích cách sử dụng phương thức delete()
trên tài nguyên Message
của API Google Chat để xoá 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 ứ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 bài viết Tổng quan về tin nhắn trên Google Chat.
Với tính năng xác thực ứng dụng, bạn có thể sử dụng phương thức này để xoá tin nhắn mà ứng dụng Chat đã gửi. Với tính năng xác thực người dùng, bạn có thể sử dụng phương thức này để xoá một tin nhắn mà người dùng đã xác thực đã gửi. Nếu người dùng đó là người quản lý không gian, thì bạn cũng có thể xoá tin nhắn mà các thành viên khác trong không gian đã gửi. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về vai trò của bạn với tư cách là Người quản lý không gian.
Đ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 Node.js Thư viện ứng dụng đám mây.
- 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 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 với tư cách là ứng dụng Chat, hãy
tạo thông tin đăng nhập cho
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 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.
Python
- Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp 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:
- Để 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.
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 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.
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.
- Trong hướng dẫn này, bạn phải sử dụng phương thức xác thực người dùng hoặc ứng dụng. Để 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ụ. Để 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 dưới dạng người dùng hay ứng dụng Chat.
Xoá thư bằng xác thực người dùng
Để xoá một thông báo có tính năng xác thực người dùng, hãy chuyển các nội dung sau vào yêu cầu:
- Chỉ định phạm vi uỷ quyền
chat.messages
. - Gọi phương thức
DeleteMessage()
. - Đặt
name
thành tên tài nguyên của thư cần xoá.
Ví dụ sau đây sẽ xoá một thông báo có 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 mã nhận dạng bằng cách gọi phương thứcListSpaces()
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.
Nếu thành công, nội dung phản hồi sẽ trống, cho biết rằng thư đã bị xoá.
Xoá tin nhắn có xác thực ứng dụng
Để xoá một thư bằng tính năng xác thực ứng dụng, hãy truyền các 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
DeleteMessage()
. - Đặt
name
thành tên tài nguyên của thư cần xoá.
Ví dụ sau đây xoá một thông báo bằng 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 mã nhận dạng bằng cách gọi phương thứcListSpaces()
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.
Nếu thành công, nội dung phản hồi sẽ trống, cho biết rằng thư đã bị xoá.
Chủ đề có liên quan
- Định dạng thư.
- Xem thông tin chi tiết về một 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.