LiveChatMessages: insert

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.

Tác động đến hạn mức: Lệnh gọi đến phương thức này có chi phí hạn mức là 20 đơn vị.

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 uỷ quyền bằng ít nhất một trong các phạm vi sau. Để đọc thêm về quy trình xác thực và uỷ quyền, hãy xem bài viết Triển khai quy trình xác thực OAuth 2.0.

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ả cá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. Trường 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 lựa chọn sau: textMessageEvent hoặc pollEvent
  • Nếu loại là textMessageEvent, hãy thêm snippet.textMessageDetails.messageText
  • Nếu loại là pollEvent, hãy thêm đối tượng snippet.pollDetails có cấu trúc như sau:
    • snippet.pollDetails.metadata.questionText (Chuỗi): Câu hỏi chính cho cuộc thăm dò ý kiến.
    • snippet.pollDetails.metadata.options (Mảng): Danh sách các đối tượng lựa chọn.
    • Yêu cầu: Bạn phải thêm tối thiểu 2 và tối đa 4 mục.
    • Thứ tự: Các mục được hiển thị tuần tự theo đúng thứ tự được liệt kê.
    • Mỗi đối tượng trong mảng phải chứa:
      • optionText (Chuỗi): Văn bản hiển thị cho lựa chọn cụ thể đó trong cuộc thăm dò ý kiến.

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ề để phản hồi lệnh gọi đến phương thức này. Để biết thêm thông tin, hãy xem bài viết API Phát trực tiếp trên YouTube – Lỗi.

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không có quyền cần thiết để tạo thông báo được chỉ định.
forbidden (403) liveChatDisabled Trò chuyện trong sự kiện phát trực tiếp được chỉ định đã bị chủ sở hữu tắt, 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 qua Live được chỉ định không còn hoạt động nữa.
invalidValue (400) messageTextInvalid Văn bản thông báo (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 đã xoá cuộc trò chuyện.
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ị tham số thành text
required (400) preconditionCheckFailed Đã có một cuộc thăm dò ý kiến đang diễn ra đượ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 và xem Yêu cầu API cũng như phản hồi của API.