- Yêu cầu HTTP
- Thông 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 không gian trên Google Chat. Để biết ví dụ, hãy xem phần Gửi tin nhắn.
Phương thức create()
yêu cầu xác thực người dùng hoặc xác thực ứng dụng. Chat sẽ phân bổ người gửi thư theo cách khác nhau tuỳ thuộc vào loại xác thực mà bạn sử dụng trong yêu cầu.
Hình ảnh sau đây cho thấy cách Chat phân bổ tin nhắn khi bạn sử dụng tính năng xác thực ứng dụng. Chat hiển thị ứng dụng Chat dưới dạng người gửi tin nhắn. Nội dung của thông báo có thể chứa văn bản (text
), thẻ (cardsV2
) và tiện ích phụ kiện (accessoryWidgets
).
Hình ảnh sau đây cho thấy cách Chat phân bổ tin nhắn khi bạn sử dụng tính năng xác thực người dùng. Chat hiển thị người dùng là người gửi tin nhắn và phân bổ ứng dụng Chat cho tin nhắn đó bằng cách hiển thị tên ứng dụng. Nội dung tin nhắn chỉ có thể chứa văn bản (text
).
Kích thước tối đa của thư (bao gồm cả nội dung thư) là 32.000 byte.
Đối với các yêu cầu webhook, phản hồi không chứa toàn bộ thông báo. Phản hồi chỉ điền vào các trường name
và thread.name
ngoài thông tin có trong yêu cầu.
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
Thông số | |
---|---|
parent |
Bắt buộc. Tên tài nguyên của không gian để tạo thông báo. Định dạng |
Tham số truy vấn
Thông số | |
---|---|
threadKey |
Không bắt buộc. Không dùng nữa: Thay vào đó, hãy sử dụng |
request |
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. |
message |
Không bắt buộc. Chỉ định xem một tin nhắn có bắt đầu một chuỗi tin nhắn hay trả lời một chuỗi tin nhắn. Chỉ hỗ trợ trong không gian có tên. Khi phản hồi các hoạt động tương tác của người dùng, trường này sẽ bị bỏ qua. Đối với hoạt động tương tác trong một chuỗi tin nhắn, tin trả lời được tạo trong chính chuỗi đó. Nếu không, tin nhắn trả lời sẽ được tạo dưới dạng chuỗi mới. |
message |
Không bắt buộc. Mã nhận dạng tuỳ chỉnh cho một thông báo. Cho phép ứng dụng 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 biểu thị trong trường Giá trị cho 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 Gán tên cho thư. |
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ể Message
mới tạo.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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 Hướng dẫn uỷ quyền.
MessageReplyOption
Chỉ định cách trả lời tin nhắn. Chúng tôi có thể sẽ thêm các tiểu bang khác trong tương lai.
Enum | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Mặc định. Bắt đầu một luồng mới. Khi sử dụng tuỳ chọn này, mọi thread ID hoặc được đưa vào đều bị bỏ qua. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Tạo thư dưới dạng thư trả lời cho chuỗi tin nhắn do thread ID hoặc chỉ định. Nếu không thành công, thông báo sẽ bắt đầu một luồng mới. |
REPLY_MESSAGE_OR_FAIL |
Tạo tin nhắn dưới dạng tin nhắn trả lời cho chuỗi do thread ID hoặc chỉ định. Nếu bạn sử dụng threadKey mới, thì một luồng mới sẽ được tạo. Nếu không tạo được thông báo, hệ thống sẽ trả về lỗi NOT_FOUND . |