Thêm lượt thích hoặc không thích cho video hoặc xóa lượt xếp hạng khỏi video.
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à 50 đơn vị.
LƯU Ý: Điều này không ảnh hưởng đến số lượt thích/không thích chính thức của video.
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/videos/rate
Uỷ quyền
Yêu cầu này cần đượ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/youtubepartner |
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ã video trên YouTube của video đang được xếp hạng hoặc bị gỡ bỏ mức phân loại. |
|
rating |
string Chỉ định điểm xếp hạng cần ghi lại. Các giá trị được chấp nhận là:
|
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 mã phản hồi HTTP 204
(No Content
).
Lỗi
Bảng sau đây xác định các thông báo lỗi mà API có thể trả về khi 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 lỗi | Nội dung mô tả |
---|---|---|
badRequest (400) |
emailNotVerified |
Người dùng phải xác minh địa chỉ email của họ trước khi xếp hạng. |
badRequest (400) |
invalidRating |
Yêu cầu chứa một giá trị không mong muốn cho tham số rating . |
badRequest (400) |
videoPurchaseRequired |
Chỉ người dùng đã thuê mới có thể xếp hạng video cho thuê. |
forbidden (403) |
forbidden |
Không thể xếp hạng video mà bạn đang cố gắng xếp hạng. Yêu cầu có thể không được uỷ quyền hợp lệ. |
forbidden (403) |
videoRatingDisabled |
Chủ sở hữu của video mà bạn đang cố gắng xếp hạng đã vô hiệu hoá mức phân loại cho video đó. |
notFound (404) |
videoNotFound |
Không tìm thấy video mà bạn đang cố gắng xếp hạng. Hãy kiểm tra giá trị tham số id của yêu cầu để đảm bảo giá trị đó là chính xác. |
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.