구현: 평점

다음 예는 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
참고: 채널에서 즐겨찾는 동영상 가져오기 흐름에 따라 사용자가 좋아요 표시한 동영상 (싫어요 동영상 제외) 목록을 검색할 수도 있습니다. 이 절차의 1단계에서 채널에 즐겨찾는 동영상의 재생목록 ID를 검색하는 대신 채널에서 좋아요 표시한 동영상의 재생목록 ID를 가져옵니다. contentDetails.relatedPlaylists.likes 속성에 값이 포함되어 있습니다.

따라서 API를 사용하면 사용자가 videos.list 메서드 또는 playlistItems.list 메서드를 사용하여 좋아하는 동영상 목록을 검색할 수 있습니다. video 리소스에서는 playlistItem 리소스가 아닌 다양한 정보가 반환되므로 필요에 가장 적합한 메서드를 선택할 수 있습니다.