Videos: rate

Thêm điểm xếp hạng thích hoặc không thích cho video hoặc xoá điểm xếp hạng khỏi video.

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à 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

Ủy 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

Tham 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.

Tham 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ị xoá mức phân loại.
rating string
Chỉ định điểm xếp hạng cần ghi nhận.

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 – Hồ sơ cho thấy 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 trước đó cho video.

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ề để 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 giá trị không mong muốn cho tham số rating.
badRequest (400) videoPurchaseRequired Chỉ người dùng đã thuê video 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 đúng.
forbidden (403) videoRatingDisabled Chủ sở hữu video mà bạn đang cố gắng xếp hạng đã tắt điểm xếp hạng cho video đó.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố gắng xếp hạng. Kiểm tra giá trị của tham số id của yêu cầu để đảm bảo rằng giá trị đó chính xác.

Hãy dùng thử!

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.