- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- MessageReplyOption
- Hãy làm thử!
Tạo tin nhắn trong phòng Google Chat. Kích thước tối đa của tin nhắn (bao gồm cả văn bản và thẻ) là 32.000 byte. Để 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 |
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 |
Tham số truy vấn
Tham số | |
---|---|
threadKey |
Không bắt buộc. Không dùng nữa: Thay vào đó, hãy dùng |
requestId |
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 |
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 |
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 Giá trị của trường này phải đáp ứng các yêu cầu sau:
Để 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 đ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 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 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 . |