Trang này được dịch bởi Cloud Translation API.

Videos: rate

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à: `dislike` – Ghi lại rằng người dùng đã xác thực không thích video. `like` – Ghi lại rằng người dùng đã xác thực thích video. `none` – Xoá mọi mức phân loại mà người dùng đã xác thực đã đặt cho video trước đó.

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.