Videos: rate

Thêm lượt thích hoặc không thích vào một video hoặc xoá lượt thích/không thích khỏi một 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

Ủ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

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ã video trên YouTube của video đang được xếp hạng hoặc bị xoá lượt xếp hạng.
rating string
Chỉ định lượt 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 lượt xếp hạng mà người dùng đã xác thực đã đặt trước đó cho video.

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ã 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 Mô tả
badRequest (400) emailNotVerified Người dùng phải xác minh địa chỉ email của mình 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ỉ những người dùng thuê video mới có thể xếp hạng video thuê.
forbidden (403) forbidden Bạn 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 cách.
forbidden (403) videoRatingDisabled Chủ sở hữu video mà bạn đang cố gắng xếp hạng đã tắt tính năng 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 trong yêu cầu để đảm bảo rằng giá trị đó là chính xác.

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.