com.google.api.services.youtube

Class YouTube

java.lang.Object

com.google.api.client.googleapis.services.AbstractGoogleClient

com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient

com.google.api.services.youtube.YouTube

public class YouTube
extends com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient

Service definition for YouTube (v3).

Supports core YouTube features, such as uploading videos, creating and managing playlists, searching for content, and much more.

For more information about this service, see the API Documentation

This service uses YouTubeRequestInitializer to initialize global parameters via its YouTube.Builder.

Since:

1.3

Author:

Google, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	YouTube.Activities The "activities" collection of methods.
static class	YouTube.Builder Builder for YouTube.
class	YouTube.Captions The "captions" collection of methods.
class	YouTube.ChannelBanners The "channelBanners" collection of methods.
class	YouTube.Channels The "channels" collection of methods.
class	YouTube.ChannelSections The "channelSections" collection of methods.
class	YouTube.Comments The "comments" collection of methods.
class	YouTube.CommentThreads The "commentThreads" collection of methods.
class	YouTube.GuideCategories The "guideCategories" collection of methods.
class	YouTube.I18nLanguages The "i18nLanguages" collection of methods.
class	YouTube.I18nRegions The "i18nRegions" collection of methods.
class	YouTube.LiveBroadcasts The "liveBroadcasts" collection of methods.
class	YouTube.LiveChatBans The "liveChatBans" collection of methods.
class	YouTube.LiveChatMessages The "liveChatMessages" collection of methods.
class	YouTube.LiveChatModerators The "liveChatModerators" collection of methods.
class	YouTube.LiveStreams The "liveStreams" collection of methods.
class	YouTube.Members The "members" collection of methods.
class	YouTube.MembershipsLevels The "membershipsLevels" collection of methods.
class	YouTube.PlaylistItems The "playlistItems" collection of methods.
class	YouTube.Playlists The "playlists" collection of methods.
class	YouTube.Search The "search" collection of methods.
class	YouTube.Sponsors The "sponsors" collection of methods.
class	YouTube.Subscriptions The "subscriptions" collection of methods.
class	YouTube.SuperChatEvents The "superChatEvents" collection of methods.
class	YouTube.Thumbnails The "thumbnails" collection of methods.
class	YouTube.VideoAbuseReportReasons The "videoAbuseReportReasons" collection of methods.
class	YouTube.VideoCategories The "videoCategories" collection of methods.
class	YouTube.Videos The "videos" collection of methods.
class	YouTube.Watermarks The "watermarks" collection of methods.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_BASE_URL The default encoded base URL of the service.
static java.lang.String	DEFAULT_BATCH_PATH The default encoded batch path of the service.
static java.lang.String	DEFAULT_ROOT_URL The default encoded root URL of the service.
static java.lang.String	DEFAULT_SERVICE_PATH The default encoded service path of the service.

Constructor Summary

Constructors

Constructor and Description
YouTube(com.google.api.client.http.HttpTransport transport, com.google.api.client.json.JsonFactory jsonFactory, com.google.api.client.http.HttpRequestInitializer httpRequestInitializer) Constructor.

Method Summary

Modifier and Type	Method and Description
YouTube.Activities	activities() An accessor for creating requests from the Activities collection.
YouTube.Captions	captions() An accessor for creating requests from the Captions collection.
YouTube.ChannelBanners	channelBanners() An accessor for creating requests from the ChannelBanners collection.
YouTube.Channels	channels() An accessor for creating requests from the Channels collection.
YouTube.ChannelSections	channelSections() An accessor for creating requests from the ChannelSections collection.
YouTube.Comments	comments() An accessor for creating requests from the Comments collection.
YouTube.CommentThreads	commentThreads() An accessor for creating requests from the CommentThreads collection.
YouTube.GuideCategories	guideCategories() An accessor for creating requests from the GuideCategories collection.
YouTube.I18nLanguages	i18nLanguages() An accessor for creating requests from the I18nLanguages collection.
YouTube.I18nRegions	i18nRegions() An accessor for creating requests from the I18nRegions collection.
protected void	initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest<?> httpClientRequest)
YouTube.LiveBroadcasts	liveBroadcasts() An accessor for creating requests from the LiveBroadcasts collection.
YouTube.LiveChatBans	liveChatBans() An accessor for creating requests from the LiveChatBans collection.
YouTube.LiveChatMessages	liveChatMessages() An accessor for creating requests from the LiveChatMessages collection.
YouTube.LiveChatModerators	liveChatModerators() An accessor for creating requests from the LiveChatModerators collection.
YouTube.LiveStreams	liveStreams() An accessor for creating requests from the LiveStreams collection.
YouTube.Members	members() An accessor for creating requests from the Members collection.
YouTube.MembershipsLevels	membershipsLevels() An accessor for creating requests from the MembershipsLevels collection.
YouTube.PlaylistItems	playlistItems() An accessor for creating requests from the PlaylistItems collection.
YouTube.Playlists	playlists() An accessor for creating requests from the Playlists collection.
YouTube.Search	search() An accessor for creating requests from the Search collection.
YouTube.Sponsors	sponsors() An accessor for creating requests from the Sponsors collection.
YouTube.Subscriptions	subscriptions() An accessor for creating requests from the Subscriptions collection.
YouTube.SuperChatEvents	superChatEvents() An accessor for creating requests from the SuperChatEvents collection.
YouTube.Thumbnails	thumbnails() An accessor for creating requests from the Thumbnails collection.
YouTube.VideoAbuseReportReasons	videoAbuseReportReasons() An accessor for creating requests from the VideoAbuseReportReasons collection.
YouTube.VideoCategories	videoCategories() An accessor for creating requests from the VideoCategories collection.
YouTube.Videos	videos() An accessor for creating requests from the Videos collection.
YouTube.Watermarks	watermarks() An accessor for creating requests from the Watermarks collection.

Methods inherited from class com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient

getJsonFactory, getObjectParser

Methods inherited from class com.google.api.client.googleapis.services.AbstractGoogleClient

batch, batch, getApplicationName, getBaseUrl, getGoogleClientRequestInitializer, getRequestFactory, getRootUrl, getServicePath, getSuppressPatternChecks, getSuppressRequiredParameterChecks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_ROOT_URL

public static final java.lang.String DEFAULT_ROOT_URL

The default encoded root URL of the service. This is determined when the library is generated and normally should not be changed.

Since:

1.7

See Also:

Constant Field Values

DEFAULT_SERVICE_PATH

public static final java.lang.String DEFAULT_SERVICE_PATH

The default encoded service path of the service. This is determined when the library is generated and normally should not be changed.

Since:

1.7

See Also:

Constant Field Values

DEFAULT_BATCH_PATH

public static final java.lang.String DEFAULT_BATCH_PATH

The default encoded batch path of the service. This is determined when the library is generated and normally should not be changed.

Since:

1.23

See Also:

Constant Field Values

DEFAULT_BASE_URL

public static final java.lang.String DEFAULT_BASE_URL

The default encoded base URL of the service. This is determined when the library is generated and normally should not be changed.

See Also:

Constant Field Values

Constructor Detail

YouTube

public YouTube(com.google.api.client.http.HttpTransport transport,
               com.google.api.client.json.JsonFactory jsonFactory,
               com.google.api.client.http.HttpRequestInitializer httpRequestInitializer)

Constructor.

Use YouTube.Builder if you need to specify any of the optional parameters.

Parameters:

transport - HTTP transport, which should normally be:

• Google App Engine: com.google.api.client.extensions.appengine.http.UrlFetchTransport
• Android: newCompatibleTransport from com.google.api.client.extensions.android.http.AndroidHttp
• Java: com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()

jsonFactory - JSON factory, which may be:

• Jackson: com.google.api.client.json.jackson2.JacksonFactory
• Google GSON: com.google.api.client.json.gson.GsonFactory
• Android Honeycomb or higher: com.google.api.client.extensions.android.json.AndroidJsonFactory

httpRequestInitializer - HTTP request initializer or null for none

Since:

1.7

Method Detail

initialize

protected void initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest<?> httpClientRequest)
                   throws java.io.IOException

Overrides:

initialize in class com.google.api.client.googleapis.services.AbstractGoogleClient

Throws:

java.io.IOException

activities

public YouTube.Activities activities()

An accessor for creating requests from the Activities collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Activities.List request = youtube.activities().list(parameters ...)
 

Returns:

the resource collection

captions

public YouTube.Captions captions()

An accessor for creating requests from the Captions collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Captions.List request = youtube.captions().list(parameters ...)
 

Returns:

the resource collection

channelBanners

public YouTube.ChannelBanners channelBanners()

An accessor for creating requests from the ChannelBanners collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.ChannelBanners.List request = youtube.channelBanners().list(parameters ...)
 

Returns:

the resource collection

channelSections

public YouTube.ChannelSections channelSections()

An accessor for creating requests from the ChannelSections collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.ChannelSections.List request = youtube.channelSections().list(parameters ...)
 

Returns:

the resource collection

channels

public YouTube.Channels channels()

An accessor for creating requests from the Channels collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Channels.List request = youtube.channels().list(parameters ...)
 

Returns:

the resource collection

commentThreads

public YouTube.CommentThreads commentThreads()

An accessor for creating requests from the CommentThreads collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.CommentThreads.List request = youtube.commentThreads().list(parameters ...)
 

Returns:

the resource collection

comments

public YouTube.Comments comments()

An accessor for creating requests from the Comments collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Comments.List request = youtube.comments().list(parameters ...)
 

Returns:

the resource collection

guideCategories

public YouTube.GuideCategories guideCategories()

An accessor for creating requests from the GuideCategories collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.GuideCategories.List request = youtube.guideCategories().list(parameters ...)
 

Returns:

the resource collection

i18nLanguages

public YouTube.I18nLanguages i18nLanguages()

An accessor for creating requests from the I18nLanguages collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.I18nLanguages.List request = youtube.i18nLanguages().list(parameters ...)
 

Returns:

the resource collection

i18nRegions

public YouTube.I18nRegions i18nRegions()

An accessor for creating requests from the I18nRegions collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.I18nRegions.List request = youtube.i18nRegions().list(parameters ...)
 

Returns:

the resource collection

liveBroadcasts

public YouTube.LiveBroadcasts liveBroadcasts()

An accessor for creating requests from the LiveBroadcasts collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.LiveBroadcasts.List request = youtube.liveBroadcasts().list(parameters ...)
 

Returns:

the resource collection

liveChatBans

public YouTube.LiveChatBans liveChatBans()

An accessor for creating requests from the LiveChatBans collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.LiveChatBans.List request = youtube.liveChatBans().list(parameters ...)
 

Returns:

the resource collection

liveChatMessages

public YouTube.LiveChatMessages liveChatMessages()

An accessor for creating requests from the LiveChatMessages collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.LiveChatMessages.List request = youtube.liveChatMessages().list(parameters ...)
 

Returns:

the resource collection

liveChatModerators

public YouTube.LiveChatModerators liveChatModerators()

An accessor for creating requests from the LiveChatModerators collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.LiveChatModerators.List request = youtube.liveChatModerators().list(parameters ...)
 

Returns:

the resource collection

liveStreams

public YouTube.LiveStreams liveStreams()

An accessor for creating requests from the LiveStreams collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.LiveStreams.List request = youtube.liveStreams().list(parameters ...)
 

Returns:

the resource collection

members

public YouTube.Members members()

An accessor for creating requests from the Members collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Members.List request = youtube.members().list(parameters ...)
 

Returns:

the resource collection

membershipsLevels

public YouTube.MembershipsLevels membershipsLevels()

An accessor for creating requests from the MembershipsLevels collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.MembershipsLevels.List request = youtube.membershipsLevels().list(parameters ...)
 

Returns:

the resource collection

playlistItems

public YouTube.PlaylistItems playlistItems()

An accessor for creating requests from the PlaylistItems collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.PlaylistItems.List request = youtube.playlistItems().list(parameters ...)
 

Returns:

the resource collection

playlists

public YouTube.Playlists playlists()

An accessor for creating requests from the Playlists collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Playlists.List request = youtube.playlists().list(parameters ...)
 

Returns:

the resource collection

search

public YouTube.Search search()

An accessor for creating requests from the Search collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Search.List request = youtube.search().list(parameters ...)
 

Returns:

the resource collection

sponsors

public YouTube.Sponsors sponsors()

An accessor for creating requests from the Sponsors collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Sponsors.List request = youtube.sponsors().list(parameters ...)
 

Returns:

the resource collection

subscriptions

public YouTube.Subscriptions subscriptions()

An accessor for creating requests from the Subscriptions collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Subscriptions.List request = youtube.subscriptions().list(parameters ...)
 

Returns:

the resource collection

superChatEvents

public YouTube.SuperChatEvents superChatEvents()

An accessor for creating requests from the SuperChatEvents collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.SuperChatEvents.List request = youtube.superChatEvents().list(parameters ...)
 

Returns:

the resource collection

thumbnails

public YouTube.Thumbnails thumbnails()

An accessor for creating requests from the Thumbnails collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Thumbnails.List request = youtube.thumbnails().list(parameters ...)
 

Returns:

the resource collection

videoAbuseReportReasons

public YouTube.VideoAbuseReportReasons videoAbuseReportReasons()

An accessor for creating requests from the VideoAbuseReportReasons collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.VideoAbuseReportReasons.List request = youtube.videoAbuseReportReasons().list(parameters ...)
 

Returns:

the resource collection

videoCategories

public YouTube.VideoCategories videoCategories()

An accessor for creating requests from the VideoCategories collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.VideoCategories.List request = youtube.videoCategories().list(parameters ...)
 

Returns:

the resource collection

videos

public YouTube.Videos videos()

An accessor for creating requests from the Videos collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Videos.List request = youtube.videos().list(parameters ...)
 

Returns:

the resource collection

watermarks

public YouTube.Watermarks watermarks()

An accessor for creating requests from the Watermarks collection.

The typical use is:

    YouTube youtube = new YouTube(...);
    YouTube.Watermarks.List request = youtube.watermarks().list(parameters ...)
 

Returns:

the resource collection