Triển khai: Xếp hạng

Những ví dụ sau đây minh họa cách sử dụng API Dữ liệu YouTube (v3) để thực hiện các chức năng liên quan đến điểm xếp hạng video.

Xếp hạng video

Gọi phương thức videos.rate để gửi xếp hạng của người dùng cho một video. Yêu cầu này phải được cấp 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 YouTube của video đang được xếp hạng (hoặc bị xoá xếp hạng).
  • Tham số rating chỉ định mức phân loại mà người dùng cho phép đối với 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 đặt xếp hạng và giá trị thứ ba xóa bất kỳ xếp hạng nào đã tồn tại trước đó cho người dùng.

Yêu cầu mẫu bên dưới sẽ đánh giá tích cực (như) video của 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 điểm xếp hạng của người dùng hiện tại của video

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 hiện được xác thực của người dùng. Trong yêu cầu của bạn, hãy đặt giá trị của thông số id thành danh sách mã video 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 cấp phép bằng OAuth 2.0.

Yêu cầu mẫu bên dưới truy xuất điểm xếp hạng của người dùng hiện tại đối với video của 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, phản hồi API sẽ cho biết 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 video do người dùng ủy quyền cho 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 này phải được cấp 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 đã thích của người dùng (nhưng 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 kênh. Ở bước 1 của quá trình đó, thay vì truy xuất ID danh sách phát cho video yêu thích của kênh, hãy truy xuất ID danh sách phát cho video đã thích của kênh. Thuộc tính contentDetails.relatedPlaylists.likes chứa giá trị.

Do đó, API 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 playlistItems.list. Vì thông tin trong tài nguyên video 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.