YouTube Java API入門

在本教程中，我將介紹Google的YouTube API ，該API可讓您使用YouTube的功能來啟用應用程序。 YouTube是“殺手級”互聯網應用程序之一，其流量占互聯網總流量的很大一部分。

在開始之前，請確保您已閱讀《 API概述指南》。我們將主要處理Data API ，它使您可以執行YouTube網站上的許多操作（搜索視頻，檢索標準供稿，查看相關內容等）。

該API有多種編程語言，我們將在本教程中使用Java。閱讀Java Developer's Guide以獲得第一個想法。還要為Google Data API JavaDoc頁面添加書簽。

讓我們準備開發環境。首先，從相應的下載部分下載GData Java客戶端。我將在本教程中使用1.41.2版本。請注意，還有一個版本2，但根據站點的情況，它是實驗性的，與版本1不兼容。

解壓縮壓縮文件，找到文件夾“ gdata \ java \ lib”，并將以下JAR包含到應用程序的類路徑中：

數據客戶端1.0.jar
gdata-youtube-2.0.jar
gdata-core-1.0.jar
gdata-media-1.0.jar

接下來，我們必須照顧依賴性。依賴包列表可以在這里找到。

包含JavaMail API以提供媒體支持。可以在這里下載。需要“ mail.jar”。
GData客戶端還在內部使用Google Collections Library 。我下載了1.0最終版本。需要“ google-collect-1.0.jar”。

確保上述所有JAR文件都包含在項目的類路徑中。

請注意，所有公共提要都是只讀的，不需要任何身份驗證。另一方面，已驗證的操作是那些包括檢索私人供稿（例如用戶的收件箱供稿）以及寫入，上載，更新和刪除操作的操作。您將需要注冊開發人員密鑰才能執行經過身份驗證的操作。但是，本教程不需要密鑰。

現在基礎架構已經準備就緒，讓我們來談談API。我們將使用的主要類是YouTubeService類。這使您可以執行與瀏覽YouTube網頁時類似的搜索查詢。每個查詢均由YouTubeQuery實例表示。每個查詢的結果（如果有）以VideoFeed對象的形式出現。

從每個提要中，可以檢索許多VideoEntry對象。從VideoEntry中，我們提取一個YoutTubeMediaGroup對象。您可以將此類想象為媒體信息的占位符（請參閱“ Media RSS”規范）。然后，我們檢索相應的MediaPlayer ，最后檢索播放器URL。我們還可以通過MediaThumbnail類獲取有關隨附縮略圖的信息。

讓我們開始使用代碼。首先，我們創建兩個模型類，這些類將用于保存有關提要和視頻的信息。第一個稱為YouTubeMedia，它包含媒體內容URL和媒體內容類型。第二個名為YouTubeVideo，其中包含有關特定視頻的所有信息（URL，嵌入式播放器URL，縮略圖和YoutTubeMedia實例）。這些的源代碼如下：

package com.javacodegeeks.youtube.model;public class YouTubeMedia {private String location;private String type;public YouTubeMedia(String location, String type) {super();this.location = location;this.type = type;}public String getLocation() {return location;}public void setLocation(String location) {this.location = location;}public String getType() {return type;}public void setType(String type) {this.type = type;} }

package com.javacodegeeks.youtube.model;import java.util.List;public class YouTubeVideo {private List<String> thumbnails;private List<YouTubeMedia> medias;private String webPlayerUrl;private String embeddedWebPlayerUrl;public List<String> getThumbnails() {return thumbnails;}public void setThumbnails(List<String> thumbnails) {this.thumbnails = thumbnails;}public List<YouTubeMedia> getMedias() {return medias;}public void setMedias(List<YouTubeMedia> medias) {this.medias = medias;}public String getWebPlayerUrl() {return webPlayerUrl;}public void setWebPlayerUrl(String webPlayerUrl) {this.webPlayerUrl = webPlayerUrl;}public String getEmbeddedWebPlayerUrl() {return embeddedWebPlayerUrl;}public void setEmbeddedWebPlayerUrl(String embeddedWebPlayerUrl) {this.embeddedWebPlayerUrl = embeddedWebPlayerUrl;}public String retrieveHttpLocation() {if (medias==null || medias.isEmpty()) {return null;}for (YouTubeMedia media : medias) {String location = media.getLocation();if (location.startsWith("http")) {return location;}}return null;}}

最后，介紹了YouTubeManager類。它可用于執行搜索查詢，并返回YouTubeVideo模型類的實例以及所有相關信息。它還會創建適當的嵌入式Web播放器URL 。這是該類的代碼：

package com.javacodegeeks.youtube;import java.net.URL;
import java.util.LinkedList;
import java.util.List;import com.google.gdata.client.youtube.YouTubeQuery;
import com.google.gdata.client.youtube.YouTubeService;
import com.google.gdata.data.media.mediarss.MediaThumbnail;
import com.google.gdata.data.youtube.VideoEntry;
import com.google.gdata.data.youtube.VideoFeed;
import com.google.gdata.data.youtube.YouTubeMediaContent;
import com.google.gdata.data.youtube.YouTubeMediaGroup;
import com.javacodegeeks.youtube.model.YouTubeMedia;
import com.javacodegeeks.youtube.model.YouTubeVideo;public class YouTubeManager {private static final String YOUTUBE_URL = "http://gdata.youtube.com/feeds/api/videos";private static final String YOUTUBE_EMBEDDED_URL = "http://www.youtube.com/v/";private String clientID;public YouTubeManager(String clientID) {this.clientID = clientID;}public List<YouTubeVideo> retrieveVideos(String textQuery, int maxResults, boolean filter, int timeout) throws Exception {YouTubeService service = new YouTubeService(clientID);service.setConnectTimeout(timeout); // millisYouTubeQuery query = new YouTubeQuery(new URL(YOUTUBE_URL));query.setOrderBy(YouTubeQuery.OrderBy.VIEW_COUNT);query.setFullTextQuery(textQuery);query.setSafeSearch(YouTubeQuery.SafeSearch.NONE);query.setMaxResults(maxResults);VideoFeed videoFeed = service.query(query, VideoFeed.class);  List<VideoEntry> videos = videoFeed.getEntries();return convertVideos(videos);}private List<YouTubeVideo> convertVideos(List<VideoEntry> videos) {List<YouTubeVideo> youtubeVideosList = new LinkedList<YouTubeVideo>();for (VideoEntry videoEntry : videos) {YouTubeVideo ytv = new YouTubeVideo();YouTubeMediaGroup mediaGroup = videoEntry.getMediaGroup();String webPlayerUrl = mediaGroup.getPlayer().getUrl();ytv.setWebPlayerUrl(webPlayerUrl);String query = "?v=";int index = webPlayerUrl.indexOf(query);String embeddedWebPlayerUrl = webPlayerUrl.substring(index+query.length());embeddedWebPlayerUrl = YOUTUBE_EMBEDDED_URL + embeddedWebPlayerUrl;ytv.setEmbeddedWebPlayerUrl(embeddedWebPlayerUrl);List<String> thumbnails = new LinkedList<String>();for (MediaThumbnail mediaThumbnail : mediaGroup.getThumbnails()) {thumbnails.add(mediaThumbnail.getUrl());}   ytv.setThumbnails(thumbnails);List<YouTubeMedia> medias = new LinkedList<YouTubeMedia>();for (YouTubeMediaContent mediaContent : mediaGroup.getYouTubeContents()) {medias.add(new YouTubeMedia(mediaContent.getUrl(), mediaContent.getType()));}ytv.setMedias(medias);youtubeVideosList.add(ytv);}return youtubeVideosList;}}

為了測試我們的類，并提供一個示例案例，我們創建以下簡單的測試類：

package com.javacodegeeks.youtube.test;import java.util.List;import com.javacodegeeks.youtube.YouTubeManager;
import com.javacodegeeks.youtube.model.YouTubeVideo;public class YouTubeTester {public static void main(String[] args) throws Exception {String clientID = "JavaCodeGeeks";String textQuery = "java code";int maxResults = 10;boolean filter = true;int timeout = 2000;YouTubeManager ym = new YouTubeManager(clientID);List<YouTubeVideo> videos = ym.retrieveVideos(textQuery, maxResults, filter, timeout);for (YouTubeVideo youtubeVideo : videos) {System.out.println(youtubeVideo.getWebPlayerUrl());System.out.println("Thumbnails");for (String thumbnail : youtubeVideo.getThumbnails()) {System.out.println("\t" + thumbnail);}System.out.println(youtubeVideo.getEmbeddedWebPlayerUrl());System.out.println("************************************");}}}

可以從此處下載本教程的Eclipse項目，包括依賴庫。

請享用！

相關文章：