REST Resource: spaces.messages

Tài nguyên: Tin nhắn

Một tin nhắn trong phòng Google Chat.

Biểu diễn dưới dạng JSON
{
  "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)
    }
  ],
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ]
}
Các trường
name

string

Tên tài nguyên ở dạng spaces/*/messages/*.

Ví dụ: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

sender

object (User)

Chỉ kết quả. Người dùng đã tạo thông báo. Nếu ứng dụng Chat của bạn xác thực với tư cách người dùng, thì kết quả sẽ được điền vào người dùng nametype.

createTime

string (Timestamp format)

Đối với các không gian được tạo trong Chat, đây là thời điểm tạo tin nhắn. Trường này chỉ cho ra kết quả, trừ phi được dùng trong các không gian nhập.

Đối với các không gian đã nhập, hãy đặt trường này thành dấu thời gian lịch sử mà tin nhắn được tạo trong nguồn để duy trì thời gian tạo ban đầu.

lastUpdateTime

string (Timestamp format)

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

deleteTime

string (Timestamp format)

Chỉ kết quả. 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.

text

string

Nội dung thư. Đường liên kết đầu tiên đến một hình ảnh, video hoặc trang web sẽ tạo một khối xem trước. Bạn cũng có thể @đề cập đến một người dùng Google Chat 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 bài viết Gửi tin nhắn văn bản.

formattedText

string

Chỉ kết quả. Chứa thông báo text có thêm các mã đánh dấu để giao tiếp định dạng. Trường này có thể không chụp được tất cả định dạng hiển thị trong giao diện người dùng, nhưng bao gồm những nội dung sau:

  • Cú pháp đánh dấu cho khối in đậm, in nghiêng, gạch ngang, đơn cách và đơn cách.
  • Người dùng đề cập 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 hiển thị – ví dụ: <http://example.com|custom text>.
  • Biểu tượng cảm xúc tuỳ chỉnh ở định dạng :{emoji_name}: – 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.

Để 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ư

cards[]
(deprecated)

object (Card)

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

Các thẻ phong phú, có định dạng và có tính tương tác mà bạn có thể sử 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. Thẻ thường được hiển thị bên dưới phần nội dung văn bản thuần tuý của thư. cardscardsV2 có thể có kích thước tối đa là 32 KB.

cardsV2[]

object (CardWithId)

Một dãy thẻ.

Chỉ ứ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 người dùng, thì tin nhắn không được chứa thẻ.

Để tìm hiểu về thẻ và cách tạo thẻ, hãy xem bài viết Thiết kế giao diện người dùng linh động, tương tác và nhất quán bằng thẻ.

annotations[]

object (Annotation)

Chỉ kết quả. Chú thích liên quan đến text trong thông báo này.

thread

object (Thread)

Chuỗi có tin nhắn. Để tìm hiểu 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.

space

object (Space)

Nếu ứng dụng Chat của bạn xác thực với tư cách người dùng, thì kết quả sẽ được điền vào không gian name.

fallbackText

string

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ị thẻ thực tế, ví dụ: thông báo trên thiết bị di động.

actionResponse

object (ActionResponse)

Chỉ nhập. Các thông số mà ứng dụng trong Chat có thể dùng để định cấu hình cách đăng câu trả lời.

argumentText

string

Chỉ kết quả. Nội dung tin nhắn và tất cả lượt đề cập đến ứng dụng Chat đều bị loại bỏ.

slashCommand

object (SlashCommand)

Chỉ kết quả. Thông tin về lệnh dấu gạch chéo, nếu có.

attachment[]

object (Attachment)

Tệp đính kèm do người dùng tải lên.

matchedUrl

object (MatchedUrl)

Chỉ kết quả. Một 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.

threadReply

boolean

Chỉ kết quả. Khi true, tin nhắn sẽ là tin nhắn phản hồi trong một chuỗi trả lời. Khi false, tin nhắn này sẽ hiển thị 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 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.

clientAssignedMessageId

string

Tên tuỳ chỉnh cho tin nhắn trong Chat được chỉ định khi tạo. Phải bắt đầu bằng client- và chỉ chứa chữ cái viết thường, chữ số và dấu gạch nối có độ dài tối đa 63 ký tự. Chỉ định trường này để nhận, cập nhật hoặc xoá thông báo bằng giá trị được chỉ định. Việc chỉ định tên tuỳ chỉnh cho phép ứng dụng Chat gọi lại tin nhắn mà không cần lưu tin nhắn name khỏi nội dung phản hồi được trả về khi tạo tin nhắn. Việc chỉ định tên tuỳ chỉnh không thay thế trường name đã tạo (tên tài nguyên của thông báo). Thay vào đó, thuộc tính này sẽ đặt tên tuỳ chỉnh là trường clientAssignedMessageId mà bạn có thể tham chiếu trong khi xử lý các thao tác sau này, chẳng hạn như cập nhật hoặc xoá thông báo. Để xem ví dụ về cách sử dụng, hãy xem phần Đặt tên cho thông báo được tạo.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Chỉ kết quả. Danh sách tóm tắt biểu tượng cảm xúc trên tin nhắn.

deletionMetadata

object (DeletionMetadata)

Chỉ kết quả. Thông tin về một tin nhắn đã bị xoá. Một thông báo sẽ bị xoá khi bạn đặt deleteTime.

quotedMessageMetadata

object (QuotedMessageMetadata)

Chỉ kết quả. Thông tin về tin nhắn được 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.

attachedGifs[]

object (AttachedGif)

Chỉ kết quả. Ảnh GIF được đính kèm vào thư.

Thẻ có mã nhận dạng

Một thẻ trong tin nhắn trên Google Chat.

Chỉ ứ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 người dùng, thì tin nhắn không được chứa thẻ.

Biểu diễn dưới dạng JSON
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Các trường
cardId

string

Bắt buộc nếu tin nhắn chứa nhiều thẻ. Giá trị nhận dạng duy nhất của một thẻ trong tin nhắn.

card

object (Card)

Thẻ. Kích thước tối đa là 32 KB.

Annotation

Chỉ kết quả. Chú thích liên kết với phần nội dung văn bản thuần tuý của thông báo. Để thêm định dạng cơ bản cho tin nhắn văn bản, hãy xem phần Định dạng tin nhắn văn bản.

Ví dụ về nội dung thông báo ở dạng văn bản thuần tuý:

Hello @FooBot how are you!"

Siêu dữ liệu chú thích tương ứng:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
Biểu diễn dưới dạng JSON
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  }
  // End of list of possible types for union field metadata.
}
Các trường
type

enum (AnnotationType)

Loại chú thích này.

length

integer

Độ dài của chuỗi con trong nội dung thông báo dạng văn bản thuần tuý tương ứng với chú thích này.

startIndex

integer

Chỉ mục bắt đầu (từ 0 đến hết) trong phần nội dung thông báo dạng văn bản thuần tuý mà chú thích này tương ứng.

Trường nhóm metadata. Siêu dữ liệu bổ sung về chú thích. metadata chỉ có thể là một trong những trạng thái sau đây:
userMention

object (UserMentionMetadata)

Siêu dữ liệu về lượt đề cập đến người dùng.

slashCommand

object (SlashCommandMetadata)

Siêu dữ liệu của lệnh dấu gạch chéo.

Loại chú thích

Loại chú thích.

Enum
ANNOTATION_TYPE_UNSPECIFIED Giá trị mặc định cho enum. Đừng sử dụng.
USER_MENTION Một người dùng được đề cập.
SLASH_COMMAND Lệnh dấu gạch chéo được gọi.

UserĐề cậpSiêu dữ liệu

Siêu dữ liệu chú thích cho các lượt đề cập của người dùng (@).

Biểu diễn dưới dạng JSON
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Các trường
user

object (User)

Người dùng được đề cập.

type

enum (Type)

Loại đề cập đến người dùng.

Loại

Enum
TYPE_UNSPECIFIED Giá trị mặc định cho enum. Đừng sử dụng.
ADD Thêm người dùng vào không gian.
MENTION Đề cập đến người dùng trong không gian.

SlashCommandMetadata

Siêu dữ liệu chú thích cho lệnh dấu gạch chéo (/).

Biểu diễn dưới dạng JSON
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Các trường
bot

object (User)

Ứng dụng Chat có lệnh được gọi.

type

enum (Type)

Loại lệnh dấu gạch chéo.

commandName

string

Tên của lệnh dấu gạch chéo được gọi.

commandId

string (int64 format)

Mã lệnh của lệnh dấu gạch chéo được gọi.

triggersDialog

boolean

Cho biết liệu lệnh dấu gạch chéo có dành cho hộp thoại hay không.

Loại

Enum
TYPE_UNSPECIFIED Giá trị mặc định cho enum. Đừng sử dụng.
ADD Thêm ứng dụng Chat vào không gian.
INVOKE Gọi lệnh dấu gạch chéo trong khoảng trắng.

Chuỗi hội thoại

Một chuỗi tin nhắn trong một phòng Google Chat. Để tìm hiểu 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.

Nếu chỉ định một chuỗi khi tạo tin nhắn, bạn có thể đặt trường messageReplyOption để xác định điều gì sẽ xảy ra nếu không tìm thấy chuỗi nào phù hợp.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "threadKey": string
}
Các trường
name

string

Chỉ kết quả. Tên tài nguyên của luồng.

Ví dụ: spaces/{space}/threads/{thread}

threadKey

string

Không bắt buộc. Thông tin đầu vào để tạo hoặc cập nhật chuỗi tin nhắn. Nếu không, chỉ kết quả đầu ra. Mã nhận dạng cho chuỗi. Hỗ trợ tối đa 4000 ký tự.

Đây là mã nhận dạng duy nhất của ứng dụng Chat đã đặt mã này. Ví dụ: nếu nhiều ứng dụng trong Chat tạo một tin nhắn bằng cùng một khoá chuỗi, thì tin nhắn đó sẽ được đăng trong các chuỗi khác nhau. Để trả lời trong một chuỗi tin nhắn do một người hoặc một ứng dụng khác trong Chat tạo, hãy chỉ định trường name của chuỗi tin nhắn.

Phản hồi hành động

Các thông số mà ứng dụng trong Chat có thể dùng để định cấu hình cách đăng câu trả lời.

Biểu diễn dưới dạng JSON
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  }
}
Các trường
type

enum (ResponseType)

Chỉ nhập. Loại phản hồi của ứng dụng Chat.

url

string

Chỉ nhập. URL để người dùng xác thực hoặc định cấu hình. (Chỉ dành cho loại phản hồi REQUEST_CONFIG.)

dialogAction

object (DialogAction)

Chỉ nhập. Phản hồi cho một sự kiện liên quan đến hộp thoại. Phải đi kèm với ResponseType.Dialog.

Loại phản hồi

Loại phản hồi của ứng dụng Chat.

Enum
TYPE_UNSPECIFIED Loại mặc định được xử lý là NEW_MESSAGE.
NEW_MESSAGE Đăng dưới dạng một tin nhắn mới trong chủ đề.
UPDATE_MESSAGE Cập nhật tin nhắn của ứng dụng Chat. Điều này chỉ được phép trên sự kiện CARD_CLICKED có loại người gửi tin nhắn là BOT.
UPDATE_USER_MESSAGE_CARDS Cập nhật các thẻ trên tin nhắn của người dùng. Hành động này chỉ được phép phản hồi sự kiện MESSAGE có URL trùng khớp hoặc sự kiện CARD_CLICKED có loại người gửi tin nhắn là HUMAN. Bỏ qua văn bản.
REQUEST_CONFIG Yêu cầu người dùng xác thực hoặc định cấu hình bổ sung một cách riêng tư.
DIALOG Trình bày một hộp thoại.

DialogAction

Chứa hộp thoại và mã trạng thái yêu cầu.

Biểu diễn dưới dạng JSON
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Các trường
actionStatus

object (ActionStatus)

Chỉ nhập. Trạng thái của một yêu cầu gọi hoặc gửi hộp thoại. Hiện trạng thái và thông báo cho người dùng nếu cần. Ví dụ: trong trường hợp xảy ra lỗi hoặc thành công.

Trường nhóm action.

action chỉ có thể là một trong những trạng thái sau đây:

dialog

object (Dialog)

Chỉ nhập. Hộp thoại cho yêu cầu.

Hộp thoại

Trình bao bọc xung quanh thân thẻ của hộp thoại.

Biểu diễn dưới dạng JSON
{
  "body": {
    object (Card)
  }
}
Các trường
body

object (Card)

Chỉ nhập. Nội dung của hộp thoại, được hiển thị trong một cửa sổ phụ. Ứng dụng Google Chat không hỗ trợ các thực thể thẻ sau: DateTimePicker, OnChangeAction.

Trạng thái hoạt động

Biểu thị trạng thái của một yêu cầu gọi hoặc gửi hộp thoại.

Biểu diễn dưới dạng JSON
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Các trường
statusCode

enum (Code)

Mã trạng thái.

userFacingMessage

string

Thông báo để cho người dùng biết về trạng thái yêu cầu của họ. Nếu bạn không đặt chính sách này thì một thông báo chung dựa trên statusCode sẽ được gửi đi.

Các mã lỗi chính tắc cho các API gRPC.

Đôi khi, có thể áp dụng nhiều mã lỗi. Dịch vụ phải trả về mã lỗi cụ thể nhất áp dụng. Ví dụ: ưu tiên OUT_OF_RANGE hơn FAILED_PRECONDITION nếu áp dụng cả hai mã. Tương tự, ưu tiên NOT_FOUND hoặc ALREADY_EXISTS hơn FAILED_PRECONDITION.

Enum
OK

Không phải lỗi; đã trả về khi thành công.

Ánh xạ HTTP: 200 OK

CANCELLED

Thao tác đã bị huỷ, thường là do người gọi.

Ánh xạ HTTP: Yêu cầu đóng ứng dụng 499

UNKNOWN

Lỗi không xác định. Ví dụ: lỗi này có thể được trả về khi giá trị Status nhận được từ một không gian địa chỉ khác thuộc về một không gian lỗi chưa xác định trong không gian địa chỉ này. Ngoài ra, các lỗi do API không trả về đủ thông tin lỗi có thể được chuyển đổi thành lỗi này.

Ánh xạ HTTP: Lỗi máy chủ nội bộ 500

INVALID_ARGUMENT

Ứng dụng khách chỉ định một đối số không hợp lệ. Xin lưu ý rằng giá trị này khác với FAILED_PRECONDITION. INVALID_ARGUMENT cho biết các đối số có vấn đề bất kể trạng thái của hệ thống là gì (ví dụ: tên tệp không đúng định dạng).

Ánh xạ HTTP: Yêu cầu 400 không hợp lệ

DEADLINE_EXCEEDED

Đã hết thời hạn trước khi thao tác này có thể hoàn tất. Đối với các thao tác thay đổi trạng thái của hệ thống, lỗi này có thể được trả về ngay cả khi thao tác đã hoàn tất thành công. Ví dụ: một phản hồi thành công từ một máy chủ có thể bị trì hoãn đủ lâu để hết thời hạn.

Ánh xạ HTTP: Hết thời gian chờ cổng 504

NOT_FOUND

Không tìm thấy một số thực thể đã yêu cầu (ví dụ: tệp hoặc thư mục).

Lưu ý đối với các nhà phát triển máy chủ: nếu một yêu cầu bị từ chối đối với toàn bộ nhóm người dùng, chẳng hạn như phát hành dần tính năng hoặc danh sách cho phép không có tài liệu, thì NOT_FOUND có thể được sử dụng. Nếu yêu cầu bị từ chối đối với một số người dùng trong một lớp người dùng, chẳng hạn như kiểm soát quyền truy cập dựa trên người dùng, thì bạn phải sử dụng PERMISSION_DENIED.

Ánh xạ HTTP: 404 Không tìm thấy

ALREADY_EXISTS

Thực thể mà ứng dụng cố gắng tạo (ví dụ: tệp hoặc thư mục) đã tồn tại.

Ánh xạ HTTP: Xung đột 409

PERMISSION_DENIED

Phương thức gọi không có quyền thực thi thao tác đã chỉ định. Không được sử dụng PERMISSION_DENIED cho các trường hợp từ chối do làm hết tài nguyên (thay vào đó, hãy sử dụng RESOURCE_EXHAUSTED cho những lỗi đó). Không được sử dụng PERMISSION_DENIED nếu không thể xác định phương thức gọi (thay vào đó, hãy sử dụng UNAUTHENTICATED cho những lỗi đó). Mã lỗi này không ngụ ý yêu cầu là hợp lệ hay thực thể được yêu cầu tồn tại hay đáp ứng các điều kiện tiên quyết khác.

Ánh xạ HTTP: 403 bị cấm

UNAUTHENTICATED

Yêu cầu không có thông tin xác thực hợp lệ cho thao tác.

Ánh xạ HTTP: 401 trái phép

RESOURCE_EXHAUSTED

Một số tài nguyên đã hết, có thể là hạn mức cho mỗi người dùng hoặc có thể toàn bộ hệ thống tệp đã hết dung lượng.

Ánh xạ HTTP: 429 Quá nhiều yêu cầu

FAILED_PRECONDITION

Hoạt động đã bị từ chối vì hệ thống không ở trạng thái bắt buộc để thực thi hoạt động. Ví dụ: thư mục cần xoá là thư mục không trống, thao tác rmdir được áp dụng cho thư mục không phải thư mục, v.v.

Trình triển khai dịch vụ có thể sử dụng các nguyên tắc sau để quyết định giữa FAILED_PRECONDITION, ABORTEDUNAVAILABLE: (a) Sử dụng UNAVAILABLE nếu ứng dụng chỉ có thể thử lại lệnh gọi không thành công. (b) Sử dụng ABORTED nếu ứng dụng nên thử lại ở cấp cao hơn. Ví dụ: khi một kiểm thử và tập hợp do ứng dụng chỉ định không thành công, cho biết ứng dụng cần khởi động lại trình tự đọc-sửa đổi-ghi. (c) Dùng FAILED_PRECONDITION nếu ứng dụng không nên thử lại cho đến khi trạng thái hệ thống được khắc phục rõ ràng. Ví dụ: nếu "rmdir" bị lỗi do thư mục không trống, thì hệ thống sẽ trả về FAILED_PRECONDITION vì ứng dụng không được thử lại trừ phi các tệp đã bị xoá khỏi thư mục.

Ánh xạ HTTP: Yêu cầu 400 không hợp lệ

ABORTED

Hoạt động đã bị hủy, thường do vấn đề đồng thời, chẳng hạn như lỗi kiểm tra trình tự tuần tự hoặc hủy giao dịch.

Hãy xem nguyên tắc ở trên để quyết định giữa FAILED_PRECONDITION, ABORTEDUNAVAILABLE.

Ánh xạ HTTP: Xung đột 409

OUT_OF_RANGE

Thao tác đã được thực hiện vượt quá phạm vi hợp lệ. Ví dụ: tìm kiếm hoặc đọc kết thúc tệp trong quá khứ.

Không giống như INVALID_ARGUMENT, lỗi này cho biết sự cố có thể khắc phục nếu trạng thái hệ thống thay đổi. Ví dụ: hệ thống tệp 32 bit sẽ tạo INVALID_ARGUMENT nếu được yêu cầu đọc ở độ lệch không nằm trong phạm vi [0,2^32-1], nhưng sẽ tạo OUT_OF_RANGE nếu được yêu cầu đọc từ một độ lệch vượt quá kích thước tệp hiện tại.

Có một chút trùng lặp giữa FAILED_PRECONDITIONOUT_OF_RANGE. Bạn nên sử dụng OUT_OF_RANGE (lỗi cụ thể hơn) khi áp dụng để các phương thức gọi đang lặp lại trong một không gian có thể dễ dàng tìm lỗi OUT_OF_RANGE nhằm phát hiện khi nào họ hoàn tất.

Ánh xạ HTTP: Yêu cầu 400 không hợp lệ

UNIMPLEMENTED

Thao tác này chưa được triển khai hoặc không được hỗ trợ/bật trong dịch vụ này.

Ánh xạ HTTP: 501 Chưa được triển khai

INTERNAL

Lỗi nội bộ. Điều này có nghĩa là một số bất biến mà hệ thống cơ bản dự kiến đã bị hỏng. Mã lỗi này dành riêng cho các lỗi nghiêm trọng.

Ánh xạ HTTP: Lỗi máy chủ nội bộ 500

UNAVAILABLE

Dịch vụ này hiện không dùng được. Đây rất có thể là một tình trạng tạm thời và có thể khắc phục bằng cách thử lại với thời gian đợi. Xin lưu ý rằng việc thử lại các thao tác không thay đổi không phải lúc nào cũng an toàn.

Hãy xem nguyên tắc ở trên để quyết định giữa FAILED_PRECONDITION, ABORTEDUNAVAILABLE.

Ánh xạ HTTP: 503 Dịch vụ không có sẵn

DATA_LOSS

Mất hoặc hỏng dữ liệu không thể khôi phục.

Ánh xạ HTTP: Lỗi máy chủ nội bộ 500

Lệnh SlashCommand

Lệnh dấu gạch chéo trong Google Chat.

Biểu diễn dưới dạng JSON
{
  "commandId": string
}
Các trường
commandId

string (int64 format)

Mã của lệnh dấu gạch chéo đã gọi.

Url được so khớp

Một URL trùng khớp trong tin nhắn trò chuyện. Các ứng dụng nhắn tin có thể xem trước các URL đã khớp. Để biết thêm thông tin, hãy xem phần Xem trước đường liên kết.

Biểu diễn dưới dạng JSON
{
  "url": string
}
Các trường
url

string

Chỉ kết quả. URL trùng khớp.

Tóm tắt phản ứng với biểu tượng cảm xúc

Số người đã phản ứng với tin nhắn bằng một biểu tượng cảm xúc cụ thể.

Biểu diễn dưới dạng JSON
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Các trường
emoji

object (Emoji)

Biểu tượng cảm xúc liên quan đến các lượt bày tỏ cảm xúc.

reactionCount

integer

Tổng số lượt bày tỏ cảm xúc sử dụng biểu tượng cảm xúc liên quan.

Siêu dữ liệu xoá

Thông tin về một tin nhắn đã bị xoá. Một thông báo sẽ bị xoá khi bạn đặt deleteTime.

Biểu diễn dưới dạng JSON
{
  "deletionType": enum (DeletionType)
}
Các trường
deletionType

enum (DeletionType)

Cho biết ai đã xoá thư.

Loại xoá

Ai đã xoá tin nhắn và cách thức xoá tin nhắn đó.

Enum
DELETION_TYPE_UNSPECIFIED Giá trị này không được sử dụng.
CREATOR Người dùng đã tự xoá tin nhắn của chính mình.
SPACE_OWNER Chủ sở hữu không gian đã xoá tin nhắn.
ADMIN Một quản trị viên Google Workspace đã xoá tin nhắn này.
APP_MESSAGE_EXPIRY Một ứng dụng Chat đã tự xoá tin nhắn của chính mình khi hết hạn.
CREATOR_VIA_APP Một ứng dụng nhắn tin đã thay mặt người dùng xoá tin nhắn.
SPACE_OWNER_VIA_APP Một ứng dụng nhắn tin đã thay mặt chủ sở hữu không gian xoá tin nhắn.

TríchdMessageMetadata

Thông tin về một tin nhắn được trích dẫn.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "lastUpdateTime": string
}
Các trường
name

string

Chỉ kết quả. Tên tài nguyên của tin nhắn được trích dẫn.

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

lastUpdateTime

string (Timestamp format)

Chỉ kết quả. Dấu thời gian khi tin nhắn được trích dẫn được tạo hoặc lần cập nhật tin nhắn được trích dẫn gần đây nhất.

GIF đính kèm

Ảnh GIF được URL chỉ định.

Biểu diễn dưới dạng JSON
{
  "uri": string
}
Các trường
uri

string

Chỉ kết quả. URL lưu trữ hình ảnh GIF.

Phương thức

create

Tạo tin nhắn trong một phòng Google Chat.

delete

Xoá tin nhắn.

get

Trả về chi tiết về một tin nhắn.

list

Liệt kê tin nhắn trong một không gian có người gọi là thành viên, bao gồm cả tin nhắn từ các không gian và thành viên bị chặn.

patch

Cập nhật một thông báo.

update

Cập nhật một thông báo.