REST Resource: spaces.messages

{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}

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 không gian nơi đăng tin nhắn 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ã nhận dạng tuỳ chỉnh khi tạo thông báo, bạn có thể sử dụng mã nhận dạng này để chỉ định thông báo trong 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 phần Gán tên cho thư.

object (User)

Chỉ có đầu ra. Người dùng đã tạo thư. Nếu ứng dụng Chat xác thực dưới dạng người dùng, thì kết quả sẽ điền sẵn name và type của người dùng.

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Đối với các không gian được tạo trong Chat, thời gian tạo tin nhắn. Trường này chỉ xuất, ngoại trừ khi được sử dụng trong các không gian ở chế độ nhập.

Đối với không gian ở chế độ nhập, hãy đặt trường này thành dấu thời gian trong quá khứ tại thời điểm tạo thông báo trong nguồn để giữ nguyên thời gian tạo ban đầu.

string (Timestamp format)

Chỉ có đầu ra. Thời gian người dùng chỉnh sửa thông báo gần đây nhất. Nếu chưa từng chỉnh sửa thư, trường này sẽ trống.

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tin nhắn bị xoá trong Google Chat. Nếu thư không bao giờ bị xoá, trường này sẽ trống.

string

Không bắt buộc. Nội dung thư ở dạng văn bản thuần tuý. Đường liên kết đầu tiên đến hình ảnh, video hoặc trang web sẽ tạo ra một khối xem trước. Bạn cũng có thể @thao tác nhắc đến một người dùng Google Chat hoặc mọi người trong không gian.

Để tìm hiểu cách tạo tin nhắn văn bản, hãy xem bài viết Gửi tin nhắn.

string

Chỉ có đầu ra. Chứa thông báo text với các mã đánh dấu được thêm vào để truyền đạt định dạng. Trường này có thể không ghi lại tất cả định dạng hiển thị trong giao diện người dùng, nhưng bao gồm những định dạng sau:

• Cú pháp đánh dấu cho văn bản in đậm, in nghiêng, gạch ngang, phông chữ một khoảng cách, khối phông chữ một khoảng cách và danh sách có dấu đầu dòng.

• Nội dung đề cập đến người dùng sử dụng định dạng <users/{user}>.

• Siêu liên kết tuỳ chỉnh sử dụng định dạng <{url}|{rendered_text}>, trong đó chuỗi đầu tiên là URL và chuỗi thứ hai là văn bản được hiển thị, ví dụ: <http://example.com|custom text>.

• Biểu tượng cảm xúc tuỳ chỉnh sử dụng định dạng :{emojiName}:, ví dụ: :smile:. Điều này không áp dụng cho biểu tượng cảm xúc Unicode, chẳng hạn như U+1F600 cho biểu tượng mặt cười.

Để biết thêm thông tin, hãy xem phần Xem định dạng văn bản được gửi trong một thư

object (Card)

Không dùng nữa: Hãy sử dụng cardsV2.

Thẻ đa dạng thức, được định dạng và có tính tương tác mà bạn có thể dùng để hiển thị các thành phần trên giao diện người dùng, chẳng hạn như: văn bản được định dạng, nút và hình ảnh có thể nhấp vào. Thẻ thường xuất hiện bên dưới nội dung văn bản thuần tuý của thư. cards và cardsV2 có thể có kích thước tối đa là 32 KB.

object (CardWithId)

Không bắt buộc. Một mảng thẻ.

Chỉ các ứng dụng Chat mới có thể tạo thẻ. Nếu ứng dụng Chat của bạn xác thực dưới dạng người dùng, thì tin nhắn không được chứa thẻ.

Để tìm hiểu cách tạo tin nhắn chứa thẻ, hãy xem bài viết Gửi tin nhắn.

Thiết kế và xem trước thẻ bằng Trình tạo thẻ.

object (Annotation)

Chỉ có đầu ra. Chú thích liên kết với text trong thông báo này.

object (Thread)

Chuỗi tin nhắn mà thư thuộc về. Để biết ví dụ về cách sử dụng, hãy xem phần Bắt đầu hoặc trả lời chuỗi tin nhắn.

object (Space)

Chỉ có đầu ra. Nếu ứng dụng Chat xác thực dưới dạng người dùng, thì kết quả chỉ điền vào không gian name.

string

Không bắt buộc. Nội dung mô tả bằng văn bản thuần tuý về các thẻ của thông báo, được dùng khi không thể hiển thị các thẻ thực tế (ví dụ: thông báo trên thiết bị di động).

object (ActionResponse)

Chỉ nhập. Các thông số mà ứng dụng Chat có thể sử dụng để định cấu hình cách đăng phản hồi.

string

Chỉ có đầu ra. Nội dung tin nhắn ở dạng văn bản thuần tuý, trong đó xoá tất cả nội dung đề cập đến ứng dụng Chat.

object (SlashCommand)

Chỉ có đầu ra. Thông tin về lệnh dấu gạch chéo, nếu có.

object (Attachment)

Không bắt buộc. Tệp đính kèm do người dùng tải lên.

object (MatchedUrl)

Chỉ có đầu ra. URL trong spaces.messages.text khớp với mẫu bản xem trước đường liên kết. Để biết thêm thông tin, hãy xem phần Xem trước đường liên kết.

boolean

Chỉ có đầu ra. Khi true, tin nhắn là một câu trả lời trong chuỗi tin nhắn trả lời. Khi false, tin nhắn sẽ xuất hiện trong cuộc trò chuyện cấp cao nhất của không gian dưới dạng tin nhắn đầu tiên của một chuỗi tin nhắn hoặc tin nhắn không có tin nhắn trả lời theo chuỗi.

Nếu không gian không hỗ trợ tính năng trả lời trong chuỗi tin nhắn, thì trường này luôn là false.

string

Không bắt buộc. Mã nhận dạng tuỳ chỉnh cho thông báo. Bạn có thể sử dụng trường để xác định một thư hoặc để nhận, xoá hoặc cập nhật thư. Để đặt mã nhận dạng tuỳ chỉnh, hãy chỉ định trường messageId khi bạn tạo thông báo. Để biết thông tin chi tiết, hãy xem phần Gán tên cho thư.

object (EmojiReactionSummary)

Chỉ có đầu ra. Danh sách tóm tắt các biểu tượng cảm xúc phản ứng trên tin nhắn.

object (User)

Không bắt buộc. Không thể thay đổi. Dữ liệu đầu vào để tạo thông báo, nếu không thì chỉ có dữ liệu đầu ra. Người dùng có thể xem thông báo. Khi được đặt, tin nhắn sẽ ở chế độ riêng tư và chỉ người dùng được chỉ định và ứng dụng Chat mới thấy được. Để đưa trường này vào yêu cầu, bạn phải gọi API Chat bằng cách xác thực ứng dụng và bỏ qua những thông tin sau:

• Tệp đính kèm
• Tiện ích phụ kiện

Để biết thông tin chi tiết, hãy xem bài viết Gửi tin nhắn riêng tư.

object (DeletionMetadata)

Chỉ có đầu ra. Thông tin về một thư đã xoá. Tin nhắn sẽ bị xoá khi bạn đặt deleteTime.

object (QuotedMessageMetadata)

Chỉ có đầu ra. Thông tin về một tin nhắn mà người dùng Google Chat trích dẫn trong phòng. Người dùng Google Chat có thể trích dẫn một tin nhắn để trả lời tin nhắn đó.

object (AttachedGif)

Chỉ có đầu ra. Hình ảnh GIF được đính kèm vào thư.

object (AccessoryWidget)

Không bắt buộc. Một hoặc nhiều tiện ích tương tác xuất hiện ở cuối thư. Bạn có thể thêm tiện ích phụ kiện vào những tin nhắn chứa văn bản, thẻ hoặc cả văn bản và thẻ. Không hỗ trợ cho các thông báo chứa hộp thoại. Để biết thông tin chi tiết, hãy xem phần Thêm tiện ích tương tác ở cuối thư.

Để tạo một tin nhắn có tiện ích phụ kiện, bạn cần xác thực ứng dụng.