"Added sample: java/src/main/java/com/google/api/services/samples/yo…

…utube/cmdline/data/ChannelSectionLocalizations.java"

java/src/main/java/com/google/api/services/samples/youtube/cmdline/data/ChannelSectionLocalizations.java

@@ -0,0 +1,326 @@
+/*
+ * 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.ChannelSection;
+import com.google.api.services.youtube.model.ChannelSectionListResponse;
+import com.google.api.services.youtube.model.ChannelSectionLocalization;
+import com.google.common.collect.Lists;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * This sample sets and retrieves localized metadata for a channel section by:
+ *
+ * 1. Updating language of the default metadata and setting localized metadata
+ *   for a channel section via "channelSections.update" method.
+ * 2. Getting the localized metadata for a channel section in a selected language using the
+ *   "channelSections.list" method and setting the "hl" parameter.
+ * 3. Listing the localized metadata for a channel section using the "channelSections.list" method
+ *   and including "localizations" in the "part" parameter.
+ *
+ * @author Ibrahim Ulukaya
+ */
+public class ChannelSectionLocalizations {
+
+    /**
+     * 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 channel section.
+     *
+     * @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:
+                    setChannelSectionLocalization(getId("channel section"),
+                            getDefaultLanguage(), getLanguage(), getMetadata("title"));
+                    break;
+                case GET:
+                    getChannelSectionLocalization(getId("channel section"), getLanguage());
+                    break;
+                case LIST:
+                    listChannelSectionLocalizations(getId("channel section"));
+                    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 channel section's default language and sets its localized metadata.
+     *
+     * @param channelSectionId The id parameter specifies the channel section ID for the resource
+     * that is being updated.
+     * @param defaultLanguage The language of the channel section's default metadata
+     * @param language The language of the localized metadata
+     * @param title The localized title to be set
+     * @throws IOException
+     */
+    private static void setChannelSectionLocalization(String channelSectionId,
+        String defaultLanguage, String language, String title) 
+            throws IOException {
+        // Call the YouTube Data API's channelSections.list method to retrieve channel sections.
+        ChannelSectionListResponse channelSectionListResponse = youtube.channelSections().
+            list("snippet,localizations").setId(channelSectionId).execute();
+
+        // Since the API request specified a unique channel section ID, the API
+        // response should return exactly one channel section. If the response does
+        // not contain a channel section, then the specified channel section ID was not found.
+        List<ChannelSection> channelSectionList = channelSectionListResponse.getItems();
+        if (channelSectionList.isEmpty()) {
+            System.out.println("Can't find a channel section with ID: " + channelSectionId);
+            return;
+        }
+        ChannelSection channelSection = channelSectionList.get(0);
+
+        // Modify channel section's default language and localizations properties.
+        // Ensure that a value is set for the resource's snippet.defaultLanguage property.
+        channelSection.getSnippet().setDefaultLanguage(defaultLanguage);
+
+        // Preserve any localizations already associated with the channel section. If the
+        // channel section does not have any localizations, create a new array. Append the
+        // provided localization to the list of localizations associated with the channel section.
+        Map<String, ChannelSectionLocalization> localizations = channelSection.getLocalizations();
+        if (localizations == null) {
+            localizations = new ArrayMap<String, ChannelSectionLocalization>();
+            channelSection.setLocalizations(localizations);
+        }
+        ChannelSectionLocalization channelSectionLocalization = new ChannelSectionLocalization();
+        channelSectionLocalization.setTitle(title);
+        localizations.put(language, channelSectionLocalization);
+
+        // Update the channel section resource by calling the channelSections.update() method.
+        ChannelSection channelSectionResponse = youtube.channelSections()
+            .update("snippet,localizations", channelSection).execute();
+
+        // Print information from the API response.
+        System.out.println("\n================== Updated Channel Section ==================\n");
+        System.out.println("  - ID: " + channelSectionResponse.getId());
+        System.out.println("  - Default Language: " +
+            channelSectionResponse.getSnippet().getDefaultLanguage());
+        System.out.println("  - Title(" + language + "): " +
+            channelSectionResponse.getLocalizations().get(language).getTitle());
+        System.out.println("\n-------------------------------------------------------------\n");
+    }
+
+    /**
+     * Returns localized metadata for a channel section 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 channelSectionId The id parameter specifies the channel section ID for the resource
+     * that is being updated.
+     * @param language The language of the localized metadata
+     * @throws IOException
+     */
+    private static void getChannelSectionLocalization(String channelSectionId, String language)
+        throws IOException {
+        // Call the YouTube Data API's channelSections.list method to retrieve channel sections.
+        ChannelSectionListResponse channelSectionListResponse = youtube.channelSections().
+            list("snippet").setId(channelSectionId).set("hl", language).execute();
+
+        // Since the API request specified a unique channel ID, the API
+        // response should return exactly one channel. If the response does
+        // not contain a channel, then the specified channel ID was not found.
+        List<ChannelSection> channelSectionList = channelSectionListResponse.getItems();
+        if (channelSectionList.isEmpty()) {
+            System.out.println("Can't find a channel section with ID: " + channelSectionId);
+            return;
+        }
+        ChannelSection channelSection = channelSectionList.get(0);
+
+        // Print information from the API response.
+        System.out.println("\n================== Channel Section==================\n");
+        System.out.println("  - ID: " + channelSection.getId());
+        System.out.println("  - Title(" + language + "): " +
+            channelSection.getLocalizations().get(language).getTitle());
+        System.out.println("\n-------------------------------------------------------------\n");
+    }
+
+    /**
+     * Returns a list of localized metadata for a channel section.
+     *
+     * @param channelSectionId The id parameter specifies the channel section ID for the resource
+     * that is being updated.
+     * @throws IOException
+     */
+    private static void listChannelSectionLocalizations(String channelSectionId) throws IOException {
+        // Call the YouTube Data API's channelSections.list method to retrieve channel sections.
+        ChannelSectionListResponse channelSectionListResponse = youtube.channelSections().
+            list("snippet,localizations").setId(channelSectionId).execute();
+
+        // Since the API request specified a unique channel section ID, the API
+        // response should return exactly one channel section. If the response does
+        // not contain a channel section, then the specified channel section ID was not found.
+        List<ChannelSection> channelSectionList = channelSectionListResponse.getItems();
+        if (channelSectionList.isEmpty()) {
+            System.out.println("Can't find a channel section with ID: " + channelSectionId);
+            return;
+        }
+        ChannelSection channelSection = channelSectionList.get(0);
+        Map<String, ChannelSectionLocalization> localizations = channelSection.getLocalizations();
+
+        // Print information from the API response.
+        System.out.println("\n================== Channel ==================\n");
+        System.out.println("  - ID: " + channelSection.getId());
+        for (String language : localizations.keySet()) {
+            System.out.println("  - Title(" + language + "): " +
+                localizations.get(language).getTitle());
+        }
+        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
+    }
+}