Java tutorial
/* * Copyright (c) 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package com.google.api.services.samples.youtube.cmdline.data; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.json.GoogleJsonResponseException; import com.google.api.client.util.ArrayMap; import com.google.api.services.samples.youtube.cmdline.Auth; import com.google.api.services.youtube.YouTube; import com.google.api.services.youtube.model.Video; import com.google.api.services.youtube.model.VideoListResponse; import com.google.api.services.youtube.model.VideoLocalization; import com.google.common.collect.Lists; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.util.List; import java.util.Map; import java.util.Properties; /** * This sample sets and retrieves localized metadata for a video by: * * 1. Updating language of the default metadata and setting localized metadata * for a video via "videos.update" method. * 2. Getting the localized metadata for a video in a selected language using the * "videos.list" method and setting the "hl" parameter. * 3. Listing the localized metadata for a video using the "videos.list" method and * including "localizations" in the "part" parameter. * * @author Ibrahim Ulukaya */ public class VideoLocalizations { /** * Define a global instance of a YouTube object, which will be used to make * YouTube Data API requests. */ private static YouTube youtube; /** * Set and retrieve localized metadata for a video. * * @param args command line args (not used). */ public static void main(String[] args) { // This OAuth 2.0 access scope allows for full read/write access to the // authenticated user's account. List<String> scopes = Lists.newArrayList("https://www.googleapis.com/auth/youtube"); try { // Authorize the request. Credential credential = Auth.authorize(scopes, "localizations"); // This object is used to make YouTube Data API requests. youtube = new YouTube.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-localizations-sample").build(); // Prompt the user to specify the action of the be achieved. String actionString = getActionFromUser(); System.out.println("You chose " + actionString + "."); //Map the user input to the enum values. Action action = Action.valueOf(actionString.toUpperCase()); switch (action) { case SET: setVideoLocalization(getId("video"), getDefaultLanguage(), getLanguage(), getMetadata("title"), getMetadata("description")); break; case GET: getVideoLocalization(getId("video"), getLanguage()); break; case LIST: listVideoLocalizations(getId("video")); break; } } catch (GoogleJsonResponseException e) { System.err.println("GoogleJsonResponseException code: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); e.printStackTrace(); } catch (IOException e) { System.err.println("IOException: " + e.getMessage()); e.printStackTrace(); } catch (Throwable t) { System.err.println("Throwable: " + t.getMessage()); t.printStackTrace(); } } /** * Updates a video's default language and sets its localized metadata. * * @param videoId The id parameter specifies the video ID for the resource * that is being updated. * @param defaultLanguage The language of the video's default metadata * @param language The language of the localized metadata * @param title The localized title to be set * @param description The localized description to be set * @throws IOException */ private static void setVideoLocalization(String videoId, String defaultLanguage, String language, String title, String description) throws IOException { // Call the YouTube Data API's videos.list method to retrieve videos. VideoListResponse videoListResponse = youtube.videos().list("snippet,localizations").setId(videoId) .execute(); // Since the API request specified a unique video ID, the API // response should return exactly one video. If the response does // not contain a video, then the specified video ID was not found. List<Video> videoList = videoListResponse.getItems(); if (videoList.isEmpty()) { System.out.println("Can't find a video with ID: " + videoId); return; } Video video = videoList.get(0); // Modify video's default language and localizations properties. // Ensure that a value is set for the resource's snippet.defaultLanguage property. video.getSnippet().setDefaultLanguage(defaultLanguage); // Preserve any localizations already associated with the video. If the // video does not have any localizations, create a new array. Append the // provided localization to the list of localizations associated with the video. Map<String, VideoLocalization> localizations = video.getLocalizations(); if (localizations == null) { localizations = new ArrayMap<String, VideoLocalization>(); video.setLocalizations(localizations); } VideoLocalization videoLocalization = new VideoLocalization(); videoLocalization.setTitle(title); videoLocalization.setDescription(description); localizations.put(language, videoLocalization); // Update the video resource by calling the videos.update() method. Video videoResponse = youtube.videos().update("snippet,localizations", video).execute(); // Print information from the API response. System.out.println("\n================== Updated Video ==================\n"); System.out.println(" - ID: " + videoResponse.getId()); System.out.println(" - Default Language: " + videoResponse.getSnippet().getDefaultLanguage()); System.out.println( " - Title(" + language + "): " + videoResponse.getLocalizations().get(language).getTitle()); System.out.println(" - Description(" + language + "): " + videoResponse.getLocalizations().get(language).getDescription()); System.out.println("\n-------------------------------------------------------------\n"); } /** * Returns localized metadata for a video in a selected language. * If the localized text is not available in the requested language, * this method will return text in the default language. * * @param videoId The id parameter specifies the video ID for the resource * that is being updated. * @param language The language of the localized metadata * @throws IOException */ private static void getVideoLocalization(String videoId, String language) throws IOException { // Call the YouTube Data API's videos.list method to retrieve videos. VideoListResponse videoListResponse = youtube.videos().list("snippet").setId(videoId).set("hl", language) .execute(); // Since the API request specified a unique video ID, the API // response should return exactly one video. If the response does // not contain a video, then the specified video ID was not found. List<Video> videoList = videoListResponse.getItems(); if (videoList.isEmpty()) { System.out.println("Can't find a video with ID: " + videoId); return; } Video video = videoList.get(0); // Print information from the API response. System.out.println("\n================== Video ==================\n"); System.out.println(" - ID: " + video.getId()); System.out.println(" - Title(" + language + "): " + video.getLocalizations().get(language).getTitle()); System.out.println( " - Description(" + language + "): " + video.getLocalizations().get(language).getDescription()); System.out.println("\n-------------------------------------------------------------\n"); } /** * Returns a list of localized metadata for a video. * * @param videoId The id parameter specifies the video ID for the resource * that is being updated. * @throws IOException */ private static void listVideoLocalizations(String videoId) throws IOException { // Call the YouTube Data API's videos.list method to retrieve videos. VideoListResponse videoListResponse = youtube.videos().list("snippet,localizations").setId(videoId) .execute(); // Since the API request specified a unique video ID, the API // response should return exactly one video. If the response does // not contain a video, then the specified video ID was not found. List<Video> videoList = videoListResponse.getItems(); if (videoList.isEmpty()) { System.out.println("Can't find a video with ID: " + videoId); return; } Video video = videoList.get(0); Map<String, VideoLocalization> localizations = video.getLocalizations(); // Print information from the API response. System.out.println("\n================== Video ==================\n"); System.out.println(" - ID: " + video.getId()); for (String language : localizations.keySet()) { System.out.println(" - Title(" + language + "): " + localizations.get(language).getTitle()); System.out .println(" - Description(" + language + "): " + localizations.get(language).getDescription()); } System.out.println("\n-------------------------------------------------------------\n"); } /* * Prompt the user to enter a resource ID. Then return the ID. */ private static String getId(String resource) throws IOException { String id = ""; System.out.print("Please enter a " + resource + " id: "); BufferedReader bReader = new BufferedReader(new InputStreamReader(System.in)); id = bReader.readLine(); System.out.println("You chose " + id + " for localizations."); return id; } /* * Prompt the user to enter the localized metadata. Then return the metadata. */ private static String getMetadata(String type) throws IOException { String metadata = ""; System.out.print("Please enter a localized " + type + ": "); BufferedReader bReader = new BufferedReader(new InputStreamReader(System.in)); metadata = bReader.readLine(); if (metadata.length() < 1) { // If nothing is entered, defaults to type. metadata = type + "(localized)"; } System.out.println("You chose " + metadata + " as localized " + type + "."); return metadata; } /* * Prompt the user to enter the language for the resource's default metadata. * Then return the language. */ private static String getDefaultLanguage() throws IOException { String defaultlanguage = ""; System.out.print("Please enter the language for the resource's default metadata: "); BufferedReader bReader = new BufferedReader(new InputStreamReader(System.in)); defaultlanguage = bReader.readLine(); if (defaultlanguage.length() < 1) { // If nothing is entered, defaults to "en". defaultlanguage = "en"; } System.out .println("You chose " + defaultlanguage + " as the language for the resource's default metadata."); return defaultlanguage; } /* * Prompt the user to enter a language for the localized metadata. Then return the language. */ private static String getLanguage() throws IOException { String language = ""; System.out.print("Please enter the localized metadata language: "); BufferedReader bReader = new BufferedReader(new InputStreamReader(System.in)); language = bReader.readLine(); if (language.length() < 1) { // If nothing is entered, defaults to "de". language = "de"; } System.out.println("You chose " + language + " as the localized metadata language."); return language; } /* * Prompt the user to enter an action. Then return the action. */ private static String getActionFromUser() throws IOException { String action = ""; System.out.print("Please choose action to be accomplished: "); System.out.print("Options are: 'set', 'get' and 'list' "); BufferedReader bReader = new BufferedReader(new InputStreamReader(System.in)); action = bReader.readLine(); return action; } public enum Action { SET, GET, LIST } }