Method: spaces.messages.create

Tạo thông báo. Để sử dụng thư, hãy xem phần Tạo thông báo.

Bạn cần phải xác thực. Hỗ trợ đầy đủ xác thực tài khoản dịch vụ.

Hỗ trợ việc xác thực người dùng trong Chương trình dùng thử dành cho nhà phát triển Google Workspace, một chương trình cấp quyền truy cập sớm vào một số tính năng. Xác thực người dùng yêu cầu phạm vi ủy quyền chat.messages hoặc chat.messages.create.

Vì Chat cung cấp phương thức xác thực cho webhook như một phần của URL được tạo khi webhook đăng ký, nên các webhook có thể tạo tin nhắn mà không cần có tài khoản dịch vụ hoặc hoạt động xác thực người dùng.

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

Các tham số
parent

string

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

Định dạng: space/{space}

Tham số truy vấn

Các tham số
threadKey
(deprecated)

string

Không bắt buộc. Không dùng nữa: Thay vào đó, hãy sử dụng thread.thread_key. Giá trị nhận dạng luồng mờ. Để bắt đầu hoặc thêm vào một chuỗi, hãy tạo tin nhắn và chỉ định threadKey hoặc thread.name. Để sử dụng ví dụ: 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 tin nhắn bắt đầu một chuỗi tin nhắn hay trả lời tin nhắn đó. Chỉ được hỗ trợ trong những không gian có tên.
messageId

string

Không bắt buộc. 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, số và dấu gạch nối dài tối đa 63 ký tự. Chỉ định trường này để nhận, cập nhật hoặc xóa thông báo có giá trị được chỉ định. Để sử dụng ví dụ: xem phần Đặt tên cho thư được tạo.

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 phiên bản mới tạo của Message.

Phạm vi cấp phép

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.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.

Tùy chọn trả lời tin nhắn

Chỉ định cách trả lời tin nhắn. Chúng tôi có thể sẽ bổ sung các tiểu bang khác trong tương lai.

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED Mặc định. Bắt đầu một chuỗi cuộc trò chuyện.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tạo tin nhắn trả lời chuỗi tin nhắn do thread ID hoặc threadKey chỉ định. Nếu không thành công, tin nhắn sẽ bắt đầu một chuỗi cuộc trò chuyện mới.
REPLY_MESSAGE_OR_FAIL Tạo tin nhắn trả lời chuỗi tin nhắn do thread ID hoặc threadKey chỉ định. Nếu không thành công, hệ thống sẽ trả về lỗi NOT_FOUND.