Triển khai: Điểm xếp hạng

Các ví dụ sau đây minh hoạ cách sử dụng YouTube Data API (phiên bản 3) để thực hiện các hàm liên quan đến mức phân loại video.

Xếp hạng video

Gọi phương thức videos.rate để gửi điểm xếp hạng của người dùng cho một video. Yêu cầu này phải được cho phép bằng OAuth 2.0.

Đặt hai thông số sau trong yêu cầu của bạn:

  • Tham số id chỉ định ID video trên YouTube của video đang được xếp hạng (hoặc đã bị xóa xếp hạng).
  • Tham số rating chỉ định mức phân loại mà người dùng cho phép yêu cầu ghi lại. Các giá trị thông số hợp lệ là like, dislike và none. Hai giá trị đầu tiên thiết lập điểm xếp hạng còn giá trị thứ ba xoá mọi điểm xếp hạng đã tồn tại trước đó cho người dùng.

Yêu cầu mẫu dưới đây đưa ra đánh giá tích cực (thích) cho video bài phát biểu chính tại hội nghị Google I/O năm 2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

Truy xuất xếp hạng video của người dùng hiện tại

Phương thức videos.getRating cho phép bạn truy xuất điểm xếp hạng của một hoặc nhiều video do người dùng hiện đã xác thực thực hiện. Trong yêu cầu của bạn, hãy đặt giá trị của tham số id thành danh sách mã video trên YouTube được phân tách bằng dấu phẩy cho những tài nguyên mà bạn đang truy xuất dữ liệu xếp hạng. Lưu ý rằng yêu cầu này phải được cho phép bằng OAuth 2.0.

Yêu cầu mẫu dưới đây truy xuất xếp hạng của người dùng hiện tại cho video bài phát biểu chính tại hội nghị Google I/O năm 2014. (Nếu bạn đã thực thi ví dụ trước trong APIs Explorer, thì phản hồi của API phải cho biết rằng điểm xếp hạng là like.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

Truy xuất video do người dùng hiện tại xếp hạng

Tham số myRating của phương thức videos.list cho phép bạn truy xuất danh sách các video do người dùng cho phép gửi yêu cầu API. Giá trị thông số cho biết bạn muốn truy xuất video đã thích hay không thích.

Yêu cầu mẫu bên dưới truy xuất danh sách video mà người dùng hiện tại đã xếp hạng like. Yêu cầu phải được cho phép bằng OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Lưu ý: Bạn cũng có thể truy xuất danh sách video mà người dùng đã thích (chứ không phải video không thích) bằng cách làm theo quy trình truy xuất video yêu thích của một kênh. Ở bước 1 của quy trình đó, thay vì truy xuất mã nhận dạng danh sách phát của các video yêu thích trên kênh, hãy truy xuất mã nhận dạng của danh sách phát của các video đã thích trên kênh. Thuộc tính contentDetails.relatedPlaylists.likes chứa giá trị.

Do đó, API này cho phép bạn truy xuất danh sách video mà người dùng thích bằng phương thức videos.list hoặc phương thức playlistItems.list. Vì tài nguyên video trả về thông tin khác với tài nguyên playlistItem, nên bạn có thể chọn phương thức phù hợp nhất với nhu cầu của mình.