Notice
Recent Posts
Recent Comments
«   2024/03   »
1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31
Archives
Today
Total
관리 메뉴

c

YouTube DATA API (2) - playlist 본문

Google/YouTube

YouTube DATA API (2) - playlist

iuChannel 2013. 1. 2. 13:42

YouTube 는 사용자(user-channel) 가 여러개의 동영상을 묶어 놓을 수 있는 기능을 제공합니다.

이것을 재생목록, Playlist, 이라고 합니다. 일종의 북마크, Bookmark, 와도 비슷한 기능인데요.

실제로는 그 이상의 기능을 수행할 수 있습니다. 이와 관련된 이야기는 뒤에서 계속하고, 우선 API 부터 직접 살펴보지요.


https://gdata.youtube.com/feeds/api/playlists/B54BB58F4DC29C40?v=2&alt= 


{"apiVersion": "2.1","data": {"id": "PLB54BB58F4DC29C40","author": "chanyhan","title": "Pororo Season 1","description": "","totalItems": 49,"startIndex": 1,"itemsPerPage": 25,}}


이 API 에서도 앞의 user api 와 동일하게 start-index 와 max-result option 을 사용할 수 있습니다.

기본적인 사용방법은 https://gdata.youtube.com/feeds/api/playlists/ [Playlist ID] ?v=2 [&options] 입니다.

여기서 주의해야할 것은 [Playlist ID] 값입니다.

위 입력값에서 보시면 [Playlist ID] = B54BB58F4DC29C40 입니다만, 결과값에서는 "data"-"id":"PLB54BB58F4DC29C40" 라는 것을 확인할 수 있습니다.

보통 플레이리스트의 아이디 값으로는 PL 이라는 Prefix 가 붙지만, 실제 API 를 호출할 때는 PL 을 지우고 사용하셔야 합니다.


일단 결과 값은 user api 를 사용했을 때와 거의 동일하니 위 결과값에 대한 설명은 생략하겠습니다.


아래는 "items" 배열의 결과 값 중 하나입니다.



{
"id": "PLSlR4rjeFeOOxEKqleFT_Hn3_sSL923rB","position": 1,"author": "chanyhan","video": {"id": "QQyYCAvkOXY","uploaded": "2011-05-27T01:53:07.000Z","updated": "2013-01-02T02:05:24.000Z","uploader": "pororotv","category": "Shows","title": "뽀로로 - S1_1화 우리는 친구","description": "얼음 나라 작은 숲속 마을에 호기심 많은 꼬마 펭귄 뽀로로가 살고 있었어요. 여느 때 처럼 얼음 동산에서 신나게 놀던 뽀로로는 숲속 나무 밑에서 커다란 알을 발견하게 되었답니다. 알을 보고 배가 고파진 뽀로로는 집으로 가져와 요리를 하려고 하는데, 알이 깨지며 나타난 것은 아기 공룡이었어요. 뽀로로는 무서운 공룡을 상상하고 겁에 질려 도망치기 시작하는데...","duration": 301,"rating": 2.7650375,"likeCount": "939","ratingCount": 2128,"viewCount": 1881367,"favoriteCount": 0,"commentCount": 58,}},


1 depth 의 값들보다는 "video" 하위의 2 depth 값들이 이 재생목록에 추가된 동영상(video)의 정보가 중요합니다.

- id : video(재생목록) 의 아이디입니다. 이 값을 이용해서, 직접 video 를 재생할 수 있습니다.

- uploaded : 동영상을 업로드한 날짜

- updated : 업데이트 된 날짜

- uploader : 업로드한 사람

- category : 분류 - 보통 업로드한 사람이 설정해 놓는 것으로 동영상이 어떤 종류인지 알 수 있습니다. 

    https://developers.google.com/youtube/2.0/reference#Category_search 에서 보시면 category 에 어떤 값들이 들어갈 수 있는지 알 수 있습니다. 

- title : 제목

- description : 설명

- thumnail : 대표 이미지 썸네일

- player, content : 생략

- duration : 재생 시간, 단위:초

- rating : 별점

- likeCount : 좋아요 횟수

- ratingCount : 별점 횟수

- viewCount : 시청 횟수

- favoriteCount 

- commentCount : 댓글 갯수

- contentRating : 컨텐츠 수위 (이를 테면, 19금 과 같은 정보입니다.)

- accessControl : 접근제어, commnet, commentVote, rate, autoPlay 와 같은 정보를 허용하는지 아닌지를 알려주는 정보입니다. 이 필드 안의 syndicate 필드는 mobile 에서 재생이 허용되어 있는지 아닌지를 알려줍니다.


이 API 를 호출한 내용들은 

http://www.youtube.com/playlist?list=PLB54BB58F4DC29C40



에서 볼 수 있습니다.