LiveChatMessages: insert

Thêm tin nhắn vào cuộc trò chuyện trực tiếp. API hiện chỉ hỗ trợ chức năng chèn tin nhắn văn bản.

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 yêu cầu uỷ quyền có ít nhất một trong các phạm vi sau (đọc thêm về xác thực và cấp phép).

Phạm vi
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Các tham số

Bảng sau trình bày các tham số mà truy vấn này hỗ trợ. Tất cả thông số được liệt kê đều là thông số truy vấn.

Các tham số
Các thông số bắt buộc
part string
Tham số part phục vụ cho hai mục đích. Thẻ 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 API sẽ đưa vào. Đặt giá trị thông số thành snippet.

Nội dung yêu cầu

Cung cấp 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 một giá trị cho các thuộc tính này:

    • snippet.liveChatId
    • snippet.type: Hiện tại, giá trị duy nhất được hỗ trợ là textMessageEvent.
    • snippet.textMessageDetails.messageText

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên liveChatMessage 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ề khi một lệnh gọi đến phương thức này. Vui lòng 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 Thông tin 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 đã chỉ định.
forbidden (403) liveChatDisabled Chủ sở hữu đã tắt cuộc trò chuyện trực tiếp được chỉ định, nghĩa 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 mà bạn chỉ định không còn tồn tại.
invalidValue (400) messageTextInvalid Văn bản 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 chủ sở hữu đã xóa cuộc trò chuyện.
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.
required (400) liveChatIdRequired Tài nguyên liveChatMessage 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ên liveChatMessage 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ên liveChatMessage 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

Hãy dùng thử!

Hãy 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.