다음 예는 YouTube Data API (v3)를 사용하여 동영상 등급과 관련된 기능을 수행하는 방법을 보여줍니다.
동영상 평가하기
videos.rate
메서드를 호출하여 동영상에 대한 사용자 평점을 제출합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.
요청에 다음 두 매개변수를 설정합니다.
id
매개변수는 평가 중인 (또는 평점이 삭제되는) 동영상의 YouTube 동영상 ID를 지정합니다.rating
매개변수는 요청을 승인한 사용자가 기록하고자 하는 평점을 지정합니다. 유효한 매개변수 값은like
,dislike
,none
입니다. 처음 두 값은 평점을 설정하고 세 번째 값은 이전에 사용자에 대해 존재했던 평점을 삭제합니다.
아래의 샘플 요청은 2014년 Google I/O 컨퍼런스에서 진행된 기조연설의 동영상을 긍정적으로 (좋아요) 평가했습니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
동영상의 현재 사용자 평가 검색
videos.getRating
메서드를 사용하면 하나 이상의 동영상에 대해 현재 인증된 사용자의 평점을 검색할 수 있습니다. 요청에서 id
매개변수의 값을 평가 데이터를 검색하는 리소스에 대한 YouTube 동영상 ID의 쉼표로 구분된 목록으로 설정합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.
아래의 샘플 요청은 2014년 Google I/O 컨퍼런스에서 기조연설 동영상에 대한 현재 사용자의 평점을 검색합니다. API 탐색기에서 이전 예를 실행한 경우 API 응답은 등급이 like
이라고 표시해야 합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
현재 사용자가 평가한 동영상을 검색합니다.
videos.list
메서드의 myRating
매개변수를 사용하면 API 요청을 승인한 사용자가 평가한 동영상 목록을 가져올 수 있습니다. 매개변수 값은 좋아요 또는 싫어요를 검색할지 여부를 나타냅니다.
아래 샘플 요청은 현재 사용자가 like
평가를 제공한 동영상 목록을 검색합니다. 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
contentDetails.relatedPlaylists.likes
속성에 값이 포함되어 있습니다.따라서 API를 사용하면 사용자가
videos.list
메서드 또는 playlistItems.list
메서드를 사용하여 좋아하는 동영상 목록을 검색할 수 있습니다. video
리소스에서는 playlistItem
리소스가 아닌 다양한 정보가 반환되므로 필요에 가장 적합한 메서드를 선택할 수 있습니다.