Thêm tin nhắn hoặc cuộc thăm dò ý kiến vào cuộc trò chuyện trực tiếp.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
Ủy quyền
Yêu cầu này cần có sự uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về tính năng xác thực và uỷ quyền).
Phạm vi |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Thông số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.
Thông số | ||
---|---|---|
Tham số bắt buộc | ||
part |
string Tham số part phục vụ hai mục đích. Mã này xác định các thuộc tính mà thao tác ghi sẽ đặt cũng như các thuộc tính mà phản hồi của API sẽ bao gồm. Đặt giá trị tham số thành snippet . |
Nội dung yêu cầu
Cung cấp một tài nguyên liveChatMessage trong nội dung yêu cầu. Đối với tài nguyên đó, bạn phải chỉ định giá trị cho các thuộc tính này
snippet.liveChatId
snippet.type
– chọn một trong các tuỳ chọn sau:textMessageEvent
hoặcpollEvent
- Nếu loại là
textMessageEvent
, hãy bao gồmsnippet.textMessageDetails.messageText
- Nếu loại là
pollEvent
, hãy thêmsnippet.pollDetails
cùng với các giá trị sau:snippet.pollDetails.metadata.options.questionText
- Danh sách
snippet.pollDetails.metadata.options.optionText
. Bạn phải liệt kê tối thiểu 2 và tối đa 5 mục. Các mặt hàng được trình bày tuần tự theo thứ tự được liệt kê.
Phản hồi
Nếu thành công, phương thức này sẽ trả về một tài nguyênliveChatMessage trong nội dung phản hồi.
Lỗi
Bảng sau đây xác định các thông báo lỗi mà API có thể trả về để phản hồi lệnh gọi đến phương thức này. Hãy xem tài liệu về thông báo lỗi để biết thêm thông tin chi tiết.
Loại lỗi | Chi tiết về lỗi | Mô tả |
---|---|---|
forbidden (403) |
forbidden |
Bạn không có các quyền cần thiết để tạo thông báo được chỉ định. |
forbidden (403) |
liveChatDisabled |
Chủ sở hữu đã tắt cuộc trò chuyện trực tiếp được chỉ định, tức là không thể thêm tin nhắn vào cuộc trò chuyện. |
forbidden (403) |
liveChatEnded |
Cuộc trò chuyện trực tiếp được chỉ định không còn trực tiếp nữa. |
invalidValue (400) |
messageTextInvalid |
Nội dung tin nhắn (snippet.textMessageDetails.messageText ) không hợp lệ. |
notFound (404) |
liveChatNotFound |
Cuộc trò chuyện trực tiếp được xác định trong yêu cầu API không tồn tại. Lỗi này xảy ra nếu cuộc trò chuyện đã bị chủ sở hữu xoá. |
required (400) |
liveChatIdRequired |
Tài nguyênliveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.liveChatId . |
required (400) |
messageTextRequired |
Tài nguyênliveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.textMessageDetails.messageText . |
required (400) |
typeRequired |
Tài nguyênliveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.type . Đặt giá trị thông số thành text |
required (400) |
preconditionCheckFailed |
Đã có một cuộc thăm dò ý kiến đang hoạt động được ghim. |
rateLimitExceeded |
rateLimitExceeded |
Người dùng đã đăng quá nhiều tin nhắn trò chuyện trong một khung thời gian nhất định. |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này cũng như xem yêu cầu và phản hồi của API.