아래 글 YouTube DATA API (1) 을 토대로 Android ContentProvider 를 만들어 봤습니다.


Android 용 Library 와 Source 는 아래에서 확인하실 수 있습니다.

http://code.google.com/p/android-provider-for-google-api/


Sample Project 에서는 이를 이용한 예제를 보여 줍니다.

http://code.google.com/p/android-provider-for-google-api/source/browse/#svn%2Ftrunk%2FAndroidProviderSample


사용방법은 간단합니다.

1. jar 파일 다운로드

http://code.google.com/p/android-provider-for-google-api/downloads/detail?ame=androidprovider4googleopenapi.jar&can=2&q=#makechanges


2. AndroidManifest.xml 파일에 아래 코드 추가

<provider
android:name="com.iuchannel.android.provider.YouTubeProvider"
android:authorities="(PackageName).YouTubeProvider" android:grantUriPermissions="true" />


3. 아래와 같은 Uri 로 query 를 하면 결과값을 Cursor 로 받을 수 있다.

public class MainActivity extends ListActivity {
        private final static String USER_NAME="MBCClassic";
        ListView mListView;
       
SimpleCursorAdapter mAdapter;
       
AsyncQueryHandler mHandler;     
       
Uri mUri;
       
       
@Override
       
protected void onCreate(Bundle savedInstanceState) {
               
super.onCreate(savedInstanceState);
                setContentView
(R.layout.activity_main);
                mUri
=Uri.parse("content://"+getPackageName()+".YouTubeProvider/user/"+USER_NAME);
                mListView
=getListView();
               
                mAdapter
=new SimpleCursorAdapter(this, android.R.layout.simple_list_item_1, null,
                               
new String[]{"title"},
                               
new int[]{android.R.id.text1},
                               
SimpleCursorAdapter.NO_SELECTION){
                       
               
};
               
                mListView
.setAdapter(mAdapter);
                mHandler
=new AsyncQueryHandler(getContentResolver()){
                       
@Override
                       
protected void
                        onQueryComplete
(int token, Object cookie, Cursor cursor){
                               
Log.d("Test", "onQueryComplete");
                               
if(cursor==null){
                                       
Log.d("Test", "Cursor=null");
                               
}
                               
                               
if(cursor!=null && cursor.getCount()>0){
                                       
Log.d("Test", "Cursor>0");
                                        mAdapter
.swapCursor(cursor);
                                        mListView
.invalidateViews();
                               
}
                       
};
               
};               
                mHandler
.startQuery(0, null, mUri, null, null, null, null);
       
}

}


Cursor 에 넘겨주는 값들은 Const.java 에 정의 되어 있으며 아래와 같습니다.

                public final static String PRJ_ID="_id";
                public final static String PRJ_TITLE="title";
                public final static String PRJ_PLAYLIST_ID="id";
                public final static String PRJ_DESCRIPTION="description";
                public final static String PRJ_SIZE="size";
                public final static String PRJ_SQDEFAULT="sqDefault";
                public final static String PRJ_HQDEFAULT="hqDefault";
                public final static String PRJ_AUTHOR="author";
                public final static String PRJ_CREATED="created";
                public final static String PRJ_UPDATED="updated";

             

                public final static String[] USER_PLAYLIST={
                                PRJ_ID,
                                PRJ_PLAYLIST_ID,
                                PRJ_CREATED,
                                PRJ_UPDATED,
                                PRJ_AUTHOR,
                                PRJ_TITLE,
                                PRJ_DESCRIPTION,
                                PRJ_SIZE,
                                PRJ_SQDEFAULT,
                                PRJ_HQDEFAULT,
                };



아래 그림은 위의 간단한 코드로 나온 결과값입니다. 오른쪽그림은 YouTube 사이트에서 보이는 화면이구요.

위 코드에서는 Adapter 에서 title 만을 UI 에 뿌려주었기 때문에, 이와 같이 보이는 것이구요.

PRJ_SIZE, PRJ_UPDATED, PRJ_SQDEFAULT 와 같은 정보들도 같이 뿌려주면 사이트와 거의 동일한 화면을 구성할 수 있습니다.














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 를 호출한 내용들은 

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



에서 볼 수 있습니다.









그 동안 YouTube 에 공개된 Open API 를 접하면서 알게된 것들을 공유하고자 이 글을 쓰게 되었습니다.

아래 내용은 https://developers.google.com/youtube/ 의 내용을 예제와 함께 풀어 쓴 것이며, v2.0 을 기준으로 작성되었습니다.


YouTube 에 공개된 Open API 를 사용하면, 거의 YouTube 사이트와 동일한 사이트를 하나 만들 수 있을 정도로 잘 만들어져 있습니다.

Google 이 이런 정책을 펴는 이유 중 하나는 Google 은 이 정도의 Data API 를 공개해도 결국 동영상은 YouTube 를 통해 재생되기 때문에, 

그 API 를 통해 YouTube 동영상이 재생된다면, 결국 Google 은 돈을 벌 수 있기 때문입니다.


그럼, 대표적인 API 하나를 확인해 보지요.


https://gdata.youtube.com/feeds/api/users/chanyhan/playlists?v=2


위 api 는 YouTube 의 chanyhan 이라는 channel 의 playlist 를 보여주는 api 입니다.

YouTube 에서 channel(채널) = user(사용자) 와 와 같습니다.

default 는 xml 이라서 복잡해 보이고 뭐가 뭔지 잘 눈에 안보입니다.

그래서, 이에 해당하는 간략정보를 JSON 타입으로 보는 것이 개발자들에게는 좀 더 편합니다.


(1) https://gdata.youtube.com/feeds/api/users/chanyhan/playlists?v=2&alt=jsonc


url 파라미터로 &alt=jsonc 를 추가해 주시면 됩니다. 

&alt=jsonc 대신 &alt=json 을 추가해주시면, 좀 더 많은 정보를 확인할 수 있습니다.

어떤 것이 더 편한지 그건 쓰시는 분 마음입니다만, 이 글에서는 alt=jsonc 를 기본으로 가져가겠습니다.

그 이유는 jsonc 옵션이 간략하게 볼 수 있으면서도 왠간한 정보는 모두 가지고 있기 때문입니다.


아래는 Chrome 에서 JSON Formatter 라는 플러그인을 사용해서 본 결과 값입니다.

{"apiVersion": "2.1","data": {"totalItems": 10,"startIndex": 1,"itemsPerPage": 25,}}


위 API 는 YouTube 의 chanyhan 이란 사용자가 가지고 있는 Playlist 정보입니다.

총 10개(totalitems) 를 가지고 있으며, 페이지당 25개를 보여주며(itemsPerPage":25), 그 첫번째 페이지("startIndex"=1)라는 것입니다.

(1) 에서 &max-result=50 으로 설정해주시면, "itemsPerPage":50 으로 나오는 걸 확인하실 수 있습니다. 즉 기본값은 25 라는거죠.

마찬가지로 &start-index=2 로 설정해주시면, "startIndex":2 로 나오는 걸 확인하실 수 있습니다.

startIndex 는 위 결과에서 "items" 에 해당하는 결과값이 시작하는 번호의 차이입니다.


(2) https://gdata.youtube.com/feeds/api/users/chanyhan/playlists?v=2&alt=jsonc

&start-index=11&max-results=50


{"apiVersion": "2.1","data": {"totalItems": 10,"startIndex": 11,"itemsPerPage": 50}}


총 아이템 갯수가 10개이기 때문에 시작위치가 11이 되면, "data"-"items" 의 결과 값은 없게 됩니다.


이제 "items" 안의 내용들을 확인해 보지요.


{"id": "PLB54BB58F4DC29C40","created": "2011-07-26T01:03:33.000Z","updated": "2011-07-28T05:10:33.000Z","author": "chanyhan","title": "Pororo Season 1","description": "","size": 49,"thumbnail": {"sqDefault": "http://i.ytimg.com/vi/QQyYCAvkOXY/default.jpg","hqDefault": "http://i.ytimg.com/vi/QQyYCAvkOXY/hqdefault.jpg"}},


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

- created : 생성된 날짜

- updated : 업데이트 된 날짜

- author : 만든 사람

- title : 제목

- description : 설명

- size : 재생목록에 포함되어 있는 동영상의 총 갯수

- thumnail : 대표 이미지 썸네일


참고로 이 데이터들은 아래 url 에서 보여지는 것들입니다.

https://www.youtube.com/user/chanyhan/videos?flow=grid&view=1


이 item 이 실제 YouTube 사이트에서 보여지는 것은 아래와 같습니다. 













+ Recent posts

티스토리 툴바