use of com.google.api.services.youtube.model.Caption in project api-samples by youtube.
the class Captions method main.
/**
* Upload, list, update, download, and delete caption tracks.
*
* @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 and requires requests to use an SSL connection.
List<String> scopes = Lists.newArrayList("https://www.googleapis.com/auth/youtube.force-ssl");
try {
// Authorize the request.
Credential credential = Auth.authorize(scopes, "captions");
// This object is used to make YouTube Data API requests.
youtube = new YouTube.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential).setApplicationName("youtube-cmdline-captions-sample").build();
// Prompt the user to specify the action of the be achieved.
String actionString = getActionFromUser();
System.out.println("You chose " + actionString + ".");
Action action = Action.valueOf(actionString.toUpperCase());
switch(action) {
case UPLOAD:
uploadCaption(getVideoId(), getLanguage(), getName(), getCaptionFromUser());
break;
case LIST:
listCaptions(getVideoId());
break;
case UPDATE:
updateCaption(getCaptionIDFromUser(), getUpdateCaptionFromUser());
break;
case DOWNLOAD:
downloadCaption(getCaptionIDFromUser());
break;
case DELETE:
deleteCaption(getCaptionIDFromUser());
break;
default:
// All the available methods are used in sequence just for the sake
// of an example.
//Prompt the user to specify a video to upload the caption track for and
// a language, a name, a binary file for the caption track. Then upload the
// caption track with the values that are selected by the user.
String videoId = getVideoId();
uploadCaption(videoId, getLanguage(), getName(), getCaptionFromUser());
List<Caption> captions = listCaptions(videoId);
if (captions.isEmpty()) {
System.out.println("Can't get video caption tracks.");
} else {
// Retrieve the first uploaded caption track.
String firstCaptionId = captions.get(0).getId();
updateCaption(firstCaptionId, null);
downloadCaption(firstCaptionId);
deleteCaption(firstCaptionId);
}
}
} 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();
}
}
use of com.google.api.services.youtube.model.Caption in project api-samples by youtube.
the class Captions method updateCaption.
/**
* Updates a caption track's draft status to publish it.
* Updates the track with a new binary file as well if it is present. (captions.update)
*
* @param captionId The id parameter specifies the caption ID for the resource
* that is being updated. In a caption resource, the id property specifies the
* caption track's ID.
* @param captionFile caption track binary file.
* @throws IOException
*/
private static void updateCaption(String captionId, File captionFile) throws IOException {
// Modify caption's isDraft property to unpublish a caption track.
CaptionSnippet updateCaptionSnippet = new CaptionSnippet();
updateCaptionSnippet.setIsDraft(false);
Caption updateCaption = new Caption();
updateCaption.setId(captionId);
updateCaption.setSnippet(updateCaptionSnippet);
Caption captionUpdateResponse;
if (captionFile == null) {
// Call the YouTube Data API's captions.update method to update an existing caption track.
captionUpdateResponse = youtube.captions().update("snippet", updateCaption).execute();
} else {
// Create an object that contains the caption file's contents.
InputStreamContent mediaContent = new InputStreamContent(CAPTION_FILE_FORMAT, new BufferedInputStream(new FileInputStream(captionFile)));
mediaContent.setLength(captionFile.length());
// Create an API request that specifies that the mediaContent
// object is the caption of the specified video.
Update captionUpdate = youtube.captions().update("snippet", updateCaption, mediaContent);
// Set the upload type and add an event listener.
MediaHttpUploader uploader = captionUpdate.getMediaHttpUploader();
// Indicate whether direct media upload is enabled. A value of
// "True" indicates that direct media upload is enabled and that
// the entire media content will be uploaded in a single request.
// A value of "False," which is the default, indicates that the
// request will use the resumable media upload protocol, which
// supports the ability to resume an upload operation after a
// network interruption or other transmission failure, saving
// time and bandwidth in the event of network failures.
uploader.setDirectUploadEnabled(false);
// Set the upload state for the caption track file.
MediaHttpUploaderProgressListener progressListener = new MediaHttpUploaderProgressListener() {
@Override
public void progressChanged(MediaHttpUploader uploader) throws IOException {
switch(uploader.getUploadState()) {
// sent.
case INITIATION_STARTED:
System.out.println("Initiation Started");
break;
// completes.
case INITIATION_COMPLETE:
System.out.println("Initiation Completed");
break;
// uploaded.
case MEDIA_IN_PROGRESS:
System.out.println("Upload in progress");
System.out.println("Upload percentage: " + uploader.getProgress());
break;
// been successfully uploaded.
case MEDIA_COMPLETE:
System.out.println("Upload Completed!");
break;
// not started yet.
case NOT_STARTED:
System.out.println("Upload Not Started!");
break;
}
}
};
uploader.setProgressListener(progressListener);
// Upload the caption track.
captionUpdateResponse = captionUpdate.execute();
System.out.println("\n================== Uploaded New Caption Track ==================\n");
}
// Print information from the API response.
System.out.println("\n================== Updated Caption Track ==================\n");
CaptionSnippet snippet = captionUpdateResponse.getSnippet();
System.out.println(" - ID: " + captionUpdateResponse.getId());
System.out.println(" - Name: " + snippet.getName());
System.out.println(" - Language: " + snippet.getLanguage());
System.out.println(" - Draft Status: " + snippet.getIsDraft());
System.out.println("\n-------------------------------------------------------------\n");
}
use of com.google.api.services.youtube.model.Caption in project api-samples by youtube.
the class Captions method uploadCaption.
/**
* Uploads a caption track in draft status that matches the API request parameters.
* (captions.insert)
*
* @param videoId the YouTube video ID of the video for which the API should
* return caption tracks.
* @param captionLanguage language of the caption track.
* @param captionName name of the caption track.
* @param captionFile caption track binary file.
* @throws IOException
*/
private static void uploadCaption(String videoId, String captionLanguage, String captionName, File captionFile) throws IOException {
// Add extra information to the caption before uploading.
Caption captionObjectDefiningMetadata = new Caption();
// Most of the caption's metadata is set on the CaptionSnippet object.
CaptionSnippet snippet = new CaptionSnippet();
// Set the video, language, name and draft status of the caption.
snippet.setVideoId(videoId);
snippet.setLanguage(captionLanguage);
snippet.setName(captionName);
snippet.setIsDraft(true);
// Add the completed snippet object to the caption resource.
captionObjectDefiningMetadata.setSnippet(snippet);
// Create an object that contains the caption file's contents.
InputStreamContent mediaContent = new InputStreamContent(CAPTION_FILE_FORMAT, new BufferedInputStream(new FileInputStream(captionFile)));
mediaContent.setLength(captionFile.length());
// Create an API request that specifies that the mediaContent
// object is the caption of the specified video.
Insert captionInsert = youtube.captions().insert("snippet", captionObjectDefiningMetadata, mediaContent);
// Set the upload type and add an event listener.
MediaHttpUploader uploader = captionInsert.getMediaHttpUploader();
// Indicate whether direct media upload is enabled. A value of
// "True" indicates that direct media upload is enabled and that
// the entire media content will be uploaded in a single request.
// A value of "False," which is the default, indicates that the
// request will use the resumable media upload protocol, which
// supports the ability to resume an upload operation after a
// network interruption or other transmission failure, saving
// time and bandwidth in the event of network failures.
uploader.setDirectUploadEnabled(false);
// Set the upload state for the caption track file.
MediaHttpUploaderProgressListener progressListener = new MediaHttpUploaderProgressListener() {
@Override
public void progressChanged(MediaHttpUploader uploader) throws IOException {
switch(uploader.getUploadState()) {
// sent.
case INITIATION_STARTED:
System.out.println("Initiation Started");
break;
// completes.
case INITIATION_COMPLETE:
System.out.println("Initiation Completed");
break;
// uploaded.
case MEDIA_IN_PROGRESS:
System.out.println("Upload in progress");
System.out.println("Upload percentage: " + uploader.getProgress());
break;
// been successfully uploaded.
case MEDIA_COMPLETE:
System.out.println("Upload Completed!");
break;
// not started yet.
case NOT_STARTED:
System.out.println("Upload Not Started!");
break;
}
}
};
uploader.setProgressListener(progressListener);
// Upload the caption track.
Caption uploadedCaption = captionInsert.execute();
// Print the metadata of the uploaded caption track.
System.out.println("\n================== Uploaded Caption Track ==================\n");
snippet = uploadedCaption.getSnippet();
System.out.println(" - ID: " + uploadedCaption.getId());
System.out.println(" - Name: " + snippet.getName());
System.out.println(" - Language: " + snippet.getLanguage());
System.out.println(" - Status: " + snippet.getStatus());
System.out.println("\n-------------------------------------------------------------\n");
}
use of com.google.api.services.youtube.model.Caption in project api-samples by youtube.
the class Captions method listCaptions.
/**
* Returns a list of caption tracks. (captions.listCaptions)
*
* @param videoId The videoId parameter instructs the API to return the
* caption tracks for the video specified by the video id.
* @throws IOException
*/
private static List<Caption> listCaptions(String videoId) throws IOException {
// Call the YouTube Data API's captions.list method to
// retrieve video caption tracks.
CaptionListResponse captionListResponse = youtube.captions().list("snippet", videoId).execute();
List<Caption> captions = captionListResponse.getItems();
// Print information from the API response.
System.out.println("\n================== Returned Caption Tracks ==================\n");
CaptionSnippet snippet;
for (Caption caption : captions) {
snippet = caption.getSnippet();
System.out.println(" - ID: " + caption.getId());
System.out.println(" - Name: " + snippet.getName());
System.out.println(" - Language: " + snippet.getLanguage());
System.out.println("\n-------------------------------------------------------------\n");
}
return captions;
}
Aggregations