YouTube API: Dive In

1. YouTube API: Dive-InHigEdWebDev 2009Ron West

2. Google's mission …is to organize the world's information and make it universally accessible and useful. Sometimes making information accessible requires making it available in contexts other than a web browser.

3. AgendaIntroductionGetting StartedGet ContentInteractionPulling it TogetherDeveloper Community

4. IntroductionYouTube in ReviewRESTGoogle Data APIYouTube Data APIEntries/FeedsAuthentication

5. YouTube in ReviewVideosCommentsRatingsUsersCategoriesKeywords/TagsChannelsSubscriptionsMessages

6. Activity Feeds

7. Recommendations

8. Friends

9. Related Videos

10. Captions

11. Favorites

12. Insight DataRESTREpresentationalState TransferArchitectural Style – NOT – StandardMore akin to Doc Literal than RPC based Web ServiceLogical URL’s vs. Static URL’s

13. RESTClient-ServerStatelessCacheableUniform InterfaceLayered

14. RESTHTTP MethodsGet = List or RetrievePut = Replace or UpdatePost = CreateDelete = Delete

15. Pros Single endpoint for all calls

16. Lanugage, platform and transport agnostic

17. Built in error handlingConsConceptually more difficult

18. Harder to develop with (requires tools)SOAP (RPC/Doc Literal) Web Services

19. Multiple EndpointsProsLanguage and platform agnostic

20. Simpler to develop than SOAP

21. ConciseConsLack of standards

22. Tied to HTTP transportREST Web Services

23. Get API URL’s for:Comments

24. Related Videos

25. Ratings

26. Mobile

27. Versions

28. Get Video(s)

29. Edit Video

30. Delete VideoGoogle Data APIRSS vs. AtomAPPGet vs. Post vs. Put vs. Delete

31. Response CodesSame response codes for HTTP200, 201, 301, 400, 500 etc..Codes have similar meaning for each type of call200 (OK)400 (Bad Request)401 (Not Authorized)404 (Not Found)500 (Internal Error)Accompanied with error details (XML in payload)

32. YouTube Data APIVersion 1Version 2 (recommended)

33. YouTubeData APISearch for VideosKeywords (tags)CategoriesQuery Params (metadata)Search for PlaylistsKeywords (tags)CategoriesSearch for ChannelsKeywords (tags)Categories

34. YouTube Data APIRetrieveVideosCommentsCaptionsRelated VideosVideo ResponsesCategoriesKeywordsPlaylistsSubscriptionsProfilesContactsMessagesActivity FeedsInsight Data FeedFavorites

35. YouTube Data API (cont.)CreateVideosCommentsCaptionsRelated VideosVideo ResponsesComplaintRatingContactMessageFavoritePlaylistSubscription

36. YouTube Data API (cont.)UpdateVideo MetadataCaptionsProfilesPlaylistsContactsDeleteVideoMessageFavoritePlaylistSubscriptionContact

37. YouTube Data APIBatch ProcessingProcess multiple types of calls in a single requestEach Request in its own <entry> tag

38. Sample InteractionQuery API for videos tagged with “SHU”Display Videos in ListAllow user to Select Video to DisplayDisplay Single VideoRetrieve Comments for that VideoPost CommentLoginAdd to Playlist

39. Feed<feed [namespaces]> … metadata … <openSearch:totalResults /> <openSearch:startIndex /> <openSearch: itemsPerPage /> <entry> … metadata … <media:group/> </entry> <entry> … metadata … <media:group/> </entry> …</feed>

40. Entry (video)<entry [namespaces]> <title/> <content/> … metadata … <link rel=“http://gdata.youtube.com/schemas/2007#video.responses “/> <link rel=“http://gdata.youtube.com/schemas/2007#video.related” /> <link rel=“http://gdata.youtube.com/schemas/2007#mobile”/> <media:group> <media:contentyt:format=“t” url=“…”/> <media:thumbnailurl=“…” width=“…” height=“…”/> <yt: duration /> <yt:videoid /> </ media:group ></entry>

41. AuthenticationAuthSub – YouTube Authentication with “callback” API [difficult]OAuth – Standardized Approach (similar in nature to OpenID) [most difficult]ClientLogin – Custom Authentication – you call YouTube API track token [easiest]

42. Getting StartedGoogle Developers KeyDevelopment EnvironmentSamples

43. Google Developers Keyhttp://code.google.com/apis/youtube/dashboard/

44. Development EnvironmentAccessing dev serversPlugging in Developers Key

45. Getting YouTube ContentStandard FeedsDiscovering VideosChannelsPlaylistsDisplaying Videos

46. Standard Feedshttp://code.google.com/apis/youtube/2.0/reference.html#Standard_feedsTop RatedTop FavoritesMost ViewedMost PopularMost RecentEtc…Filter by TimeFilter by RegionFilter by Category

47. Discovering VideosKeywordsCategoriesCategories/KeywordsUsers

48. Categorieshttp://gdata.youtube.com/schemas/2007/categories.cat<app:categories [namespaces]><atom:category term="Film" label="Film & Animation" xml:lang="en-US"> <yt:assignable/> <yt:browsable regions="AU BR CA CZ DE ES FR GB HK IE IL IN IT JP KR MX NL NZ PL PT RU SE TW US"/></atom:category></app>

49. Video by Keyword/Taghttp://gdata.youtube.com/feeds/api/videos/Append /-/keyword/ to video feed URLUse query string ?category=keywordNot (-) Or (|)/-/Kennedy/-Bobby/-Ted/-Patrick/-/Kennedy/Bobby|Ted|Patrick

50. Video by Categoryhttp://gdata.youtube.com/feeds/api/videos/Append /-/Category/ to video feed URLUse query string ?category=CategoryMultiple Categories/-/Comedy/Music/Shortmov/?category=Comedy,Music,ShortmovCategory ARE case sensitive

51. Channelshttp://gdata.youtube.com/feeds/api/channels?v=2Search just like videos using “?q=keywords/tags”<feed [namespaces> … metadata … <openSearch:totalResults /> <openSearch:startIndex /> <openSearch: itemsPerPage /> <entry> <title /> <summary /> <gd:feedlinkurl=“…” hitcount=“…”> </entry></feed>

52. Playlistshttp://gdata.youtube.com/feeds/api/playlists/snippets?v=2Searchjustlike a Channel<feed [namespaces> … metadata … <openSearch:totalResults /> <openSearch:startIndex /> <openSearch: itemsPerPage /> <entry> <title /> <summary /> <content src=“…”> <yt:countHint /> <yt:playlistId /> </entry></feed>

53. Displaying VideosJavaScript APIFlash API

54. Interacting with YouTube ContentAuthenticationCommentsRatingsUpdatingUploading

55. ClientLoginhttps://www.google.com/youtube/accounts/ClientLoginPass in:EmailPasswdReceive: Auth=AIwbFARksypDdUSGGYRI_5v7Z9TaijoPQqpIfCEjTFPAikn_---OC-I1VJtQYouTubeUser=testuserSend into all requests:Header:Authorization = “GoogleLogin auth= AIwbFARksypDdUSGGYRI_5v7Z9TaijoPQqpIfCEjTFPAikn_---OC-I1VJtQ”

56. CommentsGet Video FeedLook for:<gd:comments><gd:feedlinkhref=“…” countHint=“…” /></gd:comments>Pass in

57. RatingsLink embeded in the video feed<link rel='http://gdata.youtube.com/schemas/2007#video.ratings' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/VIDEO_ID/ratings'/>Send back to this URL:<entry [namespaces]> <gd:rating value="4" min="1" max="5"/></entry>

58. UpdatingLink embeded in the video feed<link rel='edit' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/users/andyland74/uploads/914IMX9RSTE'> Send Back to this URL:<entry [namespaces]><media:group> <media:title type=“…“ /> <media:description type=“…“ /> <media:category scheme=“…“ /> <media:keywords /></media:group> </entry>

59. Uploadinghttp://uploads.gdata.youtube.com/feeds/api/usersInclude in HeaderAuthenticationSlug (filename)Include in BodyVideo File<entry [namespace]> <media:group> <media:title type=”...” /> <media:description type=“…“ /> <media:keywords /> <media:categoryscheme=“…“ /></media:group></entry>

60. ChallengesDocumentation is poorNo true congruity in related linksError messages are non-descriptive

61. Developer ResourcesGoogle Grouphttp://groups.google.com/group/youtube-api-gdataGoogle Code Helphttp://code.google.com/support/bin/topic.py?topic=12357

62. ContactRon West@notronwestfacebook.com/notronwestwww.notronwest.com/blog

YouTube API: Dive In

More Related Content

Viewers also liked (16)

Similar to YouTube API: Dive In (20)

Recently uploaded (20)

YouTube API: Dive In