Method: spaces.messages.create

Tạo tin nhắn trong phòng Google Chat. Để biết ví dụ, hãy xem phần Gửi tin nhắn.

Việc gọi phương thức này yêu cầu phải xác thực và hỗ trợ các loại xác thực sau:

  • Đối với tin nhắn văn bản, xác thực người dùng hoặc xác thực ứng dụng được hỗ trợ.
  • Đối với tin nhắn thẻ, hệ thống chỉ hỗ trợ xác thực ứng dụng. (Chỉ các ứng dụng trong Chat mới có thể tạo tin nhắn bằng thẻ.)

Yêu cầu HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

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

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tên tài nguyên của không gian mà bạn dùng để tạo thông báo.

Định dạng spaces/{space}

Tham số truy vấn

Tham số
threadKey
(deprecated)

string

Không bắt buộc. Không dùng nữa: Thay vào đó, hãy dùng thread.thread_key. Mã nhận dạng của chuỗi. Hỗ trợ tối đa 4000 ký tự. Để bắt đầu hoặc thêm vào một chuỗi, hãy tạo một tin nhắn và chỉ định threadKey hoặc thread.name. Để tham khảo 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.
requestId

string

Không bắt buộc. Mã yêu cầu duy nhất cho thông báo này. Việc chỉ định mã yêu cầu hiện có sẽ trả về thông báo được tạo bằng mã đó thay vì tạo thông báo mới.
messageReplyOption

enum (MessageReplyOption)

Không bắt buộc. Chỉ định việc một tin nhắn bắt đầu chuỗi hay trả lời chuỗi tin nhắn. Chỉ được hỗ trợ trong không gian được đặt tên.
messageId

string

Không bắt buộc. Mã nhận dạng tuỳ chỉnh của tin nhắn. Cho phép các ứng dụng trong Chat nhận, cập nhật hoặc xoá tin nhắn mà không cần lưu trữ mã nhận dạng do hệ thống chỉ định trong tên tài nguyên của tin nhắn (được thể hiện trong trường name của tin nhắn).

Giá trị của trường này phải đáp ứng các yêu cầu sau:

  • Bắt đầu bằng client-. Ví dụ: client-custom-name là mã tuỳ chỉnh hợp lệ, nhưng custom-name thì không.
  • Chứa tối đa 63 ký tự và chỉ chứa chữ cái viết thường, chữ số và dấu gạch nối.
  • Là duy nhất trong một không gian. Một ứng dụng Chat không thể sử dụng cùng một mã tuỳ chỉnh cho nhiều tin nhắn.

Để biết thông tin chi tiết, hãy xem phần Đặt tên cho tin nhắn.

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 thực thể mới tạo của Message.

Phạm vi uỷ quyền

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

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

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

MessageReplyOption

Chỉ định cách trả lời thư. Các tiểu bang khác có thể được thêm vào trong tương lai.

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED Mặc định. Bắt đầu một chuỗi mới. Khi sử dụng tuỳ chọn này, bạn sẽ bỏ qua mọi thread ID hoặc threadKey đi kèm.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tạo tin nhắn dưới dạng thư trả lời cho chuỗi do thread ID hoặc threadKey chỉ định. Nếu không thành công thì tin nhắn sẽ bắt đầu một chuỗi mới.
REPLY_MESSAGE_OR_FAIL Tạo tin nhắn dưới dạng thư trả lời cho chuỗi do thread ID hoặc threadKey chỉ định. Nếu một threadKey mới được dùng, thì một luồng mới sẽ được tạo. Nếu không tạo được thông báo thì hệ thống sẽ trả về lỗi NOT_FOUND.