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.

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ổ một tin nhắn khi bạn 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 tin nhắn có thể chứa văn bản (text), thẻ (cardsV2) và tiện ích phụ kiện (accessoryWidgets).

Thư được gửi bằng phương thức xác thực ứng dụng

Hình ảnh sau đây cho thấy cách Chat phân bổ một tin nhắn khi bạn sử dụng phương thức 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à cho biết tên ứng dụng Chat là tin nhắn đó. Nội dung của thông báo chỉ có thể chứa văn bản (text).

Đã gửi thư có xác thực người dùng

Kích thước tối đa của thư, bao gồm cả nội dung thư, là 32.000 byte.

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

string

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

Định dạng spaces/{space}

Tham số truy vấn

Thông số
threadKey
(deprecated)

string

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

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ã nhận dạng yêu cầu hiện có sẽ trả về thông báo được tạo bằng mã nhận dạng đó thay vì tạo một thông báo mới.

messageReplyOption

enum (MessageReplyOption)

Không bắt buộc. Chỉ định liệu 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ỉ được hỗ trợ trong không gian được đặt tên.

messageId

string

Không bắt buộc. Mã tuỳ chỉnh của một thư. 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 name của tin nhắn).

Giá trị cho 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ã nhận dạng tuỳ chỉnh hợp lệ, nhưng custom-name thì không.
  • Chứa tối đa 63 ký tự, chỉ chứa chữ cái viết thường, 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 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ể 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:

  • 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 một 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 threadKey được đưa vào đều bị bỏ qua.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tạo tin nhắn dưới dạng tin nhắn trả lời cho chuỗi 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 tin nhắn mới.
REPLY_MESSAGE_OR_FAIL Tạo thư dưới dạng thư trả lời cho chuỗi tin nhắn do thread ID hoặc threadKey chỉ định. Nếu bạn sử dụng threadKey mới, một luồng mới sẽ được tạo. Nếu không tạo được thông báo, lỗi NOT_FOUND sẽ được trả về.