구현: 평점

다음 예는 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 리소스와 다른 정보가 반환되므로 요구사항에 가장 적합한 메서드를 선택할 수 있습니다.