Method: spaces.messages.patch

Cập nhật một tin nhắn. Có sự khác biệt giữa phương thức patch và update. Phương thức patch sử dụng yêu cầu patch, còn phương thức update sử dụng yêu cầu put. Bạn nên sử dụng phương thức patch. Để biết ví dụ, hãy xem phần Cập nhật thông báo.

Hỗ trợ các loại xác thực sau:

  • Xác thực ứng dụng bằng phạm vi uỷ quyền:

    • https://www.googleapis.com/auth/chat.bot

  • Xác thực người dùng bằng một trong các phạm vi uỷ quyền sau:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (chỉ có khoảng trắng ở chế độ nhập)

Khi sử dụng tính năng xác thực ứng dụng, các yêu cầu chỉ có thể cập nhật những thông báo do ứng dụng Chat gọi tạo ra.

Yêu cầu HTTP

PATCH https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
message.name

string

Giá trị nhận dạng. Tên tài nguyên của thông báo.

Định dạng spaces/{space}/messages/{message}

Trong đó, {space} là mã nhận dạng của phòng Chat nơi tin nhắn được đăng và {message} là mã nhận dạng do hệ thống chỉ định cho tin nhắn. Ví dụ: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Nếu đặt một mã nhận dạng tuỳ chỉnh khi tạo thông báo, bạn có thể dùng mã nhận dạng này để chỉ định thông báo trong một yêu cầu bằng cách thay thế {message} bằng giá trị trong trường clientAssignedMessageId. Ví dụ: spaces/AAAAAAAAAAA/messages/client-custom-name. Để biết thông tin chi tiết, hãy xem bài viết Đặt tên cho tin nhắn.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộc. Đường dẫn đến các trường cần cập nhật. Phân tách nhiều giá trị bằng dấu phẩy hoặc dùng * để cập nhật tất cả đường dẫn trường.

Đường dẫn trường hiện được hỗ trợ:
allowMissing

boolean

Không bắt buộc. Nếu true và không tìm thấy thông báo, thì một thông báo mới sẽ được tạo và updateMask sẽ bị bỏ qua. Mã thông báo được chỉ định phải là do ứng dụng khách chỉ định, nếu không yêu cầu sẽ không thành công.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Message.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Message.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.