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

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 thông báo được đăng và {message} là mã nhận dạng do hệ thống chỉ định cho thông báo đó. Ví dụ: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Nếu đặt mã tuỳ chỉnh khi tạo thông báo, bạn có thể sử dụng mã 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 Đặt tên cho thông báo.

object (User)

Chỉ có đầu ra. Người dùng đã tạo thông báo. Nếu ứng dụng Chat xác thực với tư cách là một người dùng, thì dữ liệu đầu ra sẽ được điền cho người dùng name và type.

string (Timestamp format)

Không bắt buộc. Bất biến. Đối với những không gian được tạo trong Chat, đó là thời điểm tin nhắn được tạo. Trường này chỉ dành cho kết quả đầu ra, trừ phi được dùng trong 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 trước đây khi thông báo được tạo trong nguồn để duy trì thời gian tạo ban đầu.

string (Timestamp format)

Chỉ có đầu ra. Thời điểm người dùng chỉnh sửa thư gần đây nhất. Nếu thư chưa từng được chỉnh sửa, thì trường này 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á, thì trường này trống.

string

Nội dung thư bằng văn bản thuần tuý. Đường liên kết đầu tiên đến một 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ể đề cập đến một người dùng Google Chat bằng@ hoặc mọi người trong không gian.

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

string

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

• Cú pháp đánh dấu để in đậm, in nghiêng, gạch ngang, đơn cách, khối đơn cách và danh sách có dấu đầu dòng.

• Người dùng đề cập đến bằ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 kết xuất, ví dụ: <http://example.com|custom text>.

• Biểu tượng cảm xúc tuỳ chỉnh ở đị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 cảm xúc mặt cười toe toét.

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

object (Card)

Không dùng nữa: Chuyển sang dùng cardsV2.

Các thẻ có nội dung phong phú, 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 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)

Một mảng thẻ.

Chỉ các ứng dụng trong Chat mới có thể tạo thẻ. Nếu ứng dụng Chat của bạn xác thực với tư cách là 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 phần 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 thư chứa thư. Để biết ví dụ về cách sử dụng, hãy xem phần Bắt đầu hoặc trả lời một chuỗi tin nhắn.

object (Space)

Nếu ứng dụng Chat xác thực với tư cách người dùng, thì dữ liệu đầu ra sẽ được điền vào không gian name.

string

Nội dung mô tả dưới dạng văn bản thuần tuý về các thẻ của thông báo, được sử dụng khi không thể hiển thị 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ể dùng để định cấu hình cách đăng câu trả lời.

string

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

object (SlashCommand)

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

object (Attachment)

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ột mẫu xem trước đường liên kết. Để biết thêm thông tin, hãy xem bài viết Xem trước đường liên kết.

boolean

Chỉ có đầu ra. Khi true, tin nhắn sẽ là phản hồi trong chuỗi 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 trong chuỗi 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ợ 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ã tuỳ chỉnh của thư. Bạn có thể sử dụng trường để xác định tin nhắn, hoặc để nhận, xoá hay cập nhật tin nhắn. Để đặt mã 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 Đặt tên cho thông báo.

object (EmojiReactionSummary)

Chỉ có đầu ra. Danh sách tóm tắt về biểu tượng cảm xúc trong tin nhắn.

object (User)

Bất biến. 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 bạn đặt chính sách này, tin nhắn sẽ ở chế độ riêng tư và chỉ hiển thị với người dùng được chỉ định cũng như ứng dụng Chat. Để đưa trường này vào yêu cầu, bạn phải gọi API Chat bằng cách sử dụng tính năng xác thực ứng dụng và bỏ qua các thuộc tính sau:

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

Để biết thông tin chi tiết, hãy xem phần Gửi thư ở chế độ riêng tư.

object (DeletionMetadata)

Chỉ có đầu ra. Thông tin về một thư đã xoá. Một 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 do một người dùng Google Chat trích dẫn trong một không gian. Người dùng Google Chat có thể trích dẫn một tin nhắn để trả lời.

object (AttachedGif)

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

object (AccessoryWidget)

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 tin nhắn 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 tin nhắn bằng các tiện ích phụ kiện, bạn cần xác thực ứng dụng.