구현: 평점

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