LiveChatMessages: transition

Chuyển đổi trạng thái của một tin nhắn trong cuộc trò chuyện trực tiếp trên YouTube và bắt đầu mọi quy trình liên kết với trạng thái mới. Ví dụ: khi bạn chuyển đổi trạng thái của một cuộc thăm dò ý kiến trực tiếp thành 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 tin nhắn trong cuộc thăm dò ý kiến trực tiếp là active.

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

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages/transition

Ủy quyền

Yêu cầu này cần có quyền truy cập được uỷ quyền với í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).

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

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

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

Nội dung yêu cầu

Đừ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 liveChatMessages 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 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 Chi tiết lỗi Mô tả
forbidden (403) forbidden Bạn không có các quyền cần thiết để chuyển đổi trạng thái của tin nhắn đã chỉ định.
required (400) idRequired Tham số id bắt buộc phải xác định tin nhắn mà bạn muốn chuyển đổi trạng thái.
required (400) statusRequired Yêu cầu API phải chỉ định một giá trị cho tham số status.
notFound (404) liveChatMessagesNotFound Tin nhắn được chỉ định bởi tham số id 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 tin nhắn mà trạng thái của tin nhắn đó không thể chuyển đổi.

Hãy dùng thử!

Sử dụng APIs Explorer để gọi API này và xem Yêu cầu API và phản hồi của API.