LiveChatMessages: transition

Chuyển đổi trạng thái của tin nhắn trò chuyện trực tiếp trên YouTube và bắt đầu bất kỳ quy trình nào liên quan đến trạng thái mới. Ví dụ: khi bạn chuyển trạng thái của cuộc thăm dò ý kiến trực tiếp sang closed, YouTube sẽ kết thúc cuộc thăm dò ý kiến của tin nhắn đó. Trước khi gọi phương thức này, bạn nên xác nhận rằng giá trị của thuộc tính status cho thông báo trong cuộc thăm dò ý kiến trực tiếp là active.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition

Ủ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
id string
Tham số id chỉ định mã nhận dạng duy nhất của thông báo đang chuyển sang trạng thái khác.
status enum
Tham số status xác định trạng thái mà thông báo sẽ thay đổi. Để chuyển một thông báo sang trạng thái closed, status phải là active trong cuộc thăm dò ý kiến mà thông báo đó được liên kết.

Bạn chỉ có thể chuyển sang closed, tức là cuộc thăm dò ý kiến đã đóng.
Tham số không bắt buộc
part string
Tham số part chỉ định các phần tài nguyên liveChatMessage mà phản hồi của API sẽ đưa vào. Các giá trị được hỗ trợ: id, snippet và authorDetails.

Đặt giá trị thông số thành snippet để nhận kết quả của cuộc thăm dò ý kiến cuối cùng trong nội dung phản hồi.

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu khi gọi phương thức này.

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 liveChatTin nhắn 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. Vui lòng xem tài liệu về thông báo lỗi để biết thêm chi tiết.

Loại lỗi Chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không có quyền cần thiết để chuyển đổi trạng thái của thông báo được chỉ định.
required (400) idRequired Tham số id bắt buộc phải xác định thông báo có trạng thái bạn muốn chuyển đổi.
required (400) statusRequired Yêu cầu API phải chỉ định một giá trị cho tham số status.
notFound (404) liveChatMessagesNotFound Thông báo do tham số id chỉ định không tồn tại.
forbidden (403) modificationNotAllowed Không thể chuyển đổi trạng thái của tài nguyên liveChatMessage đã chỉ định. Tham số id có thể xác định một thông báo có trạng thái không thể chuyển đổi.

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.