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