-
Python 2.6 or greater
-
The pip package management tool
-
The Google APIs Client Library for Python:
pip install --upgrade google-api-python-client -
The google-auth, google-auth-oauthlib, and google-auth-httplib2 for user authorization.
pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2
-
Create a project in the API Console and set up credentials for a web application. Set the authorized redirect URIs as appropriate.
-
Save the client_secrets.json file associated with your credentials to a local file.
-
Copy the full code sample to a local file in the same directory as the client_secrets.json file (or modify the sample to correctly identify that file's location.
-
Run the sample from the command line and set command-line arguments as necessary:
python sample.py --arg1=value1 --arg2=value2 ... -
Most samples print something to STDOUT. You can also check the YouTube website to see the effects of requests that write data, such as requests that create playlists or channel sections.
Method: youtube.channelSections.insert
Description: This sample calls the API's channelSections.insert method to create channel sections.
The code accepts a number of command line arguments that let you specify the section's type, display style, title, position,
and content.
This sample also updates the channel's
brandingSettings.channel.showBrowseView
property so that the channel displays content in a browse view (rather than a feed view). A channel's sections are only
visible if the channel displays content in a browse view.
More information on channel sections is available in the
YouTube Help Center.
Method: youtube.subscriptions.insert
Description: This sample calls the API's subscriptions.insert method to add a subscription to a specified
channel.
Method: youtube.channels.update
Description: This sample calls the API's channels.update method to set invideoPromotion
properties for the channel.
Method: youtube.playlists.insert
Description: This sample calls the API's playlists.insert method to create a private playlist owned by the
channel authorizing the request.
Method: youtube.commentThreads.list, youtube.comments.insert, youtube.comments.list, youtube.comments.update,
youtube.comments.setModerationStatus, youtube.comments.markAsSpam, youtube.comments.delete
Description: This sample demonstrates how to use the following API methods to create and manage comments:
- It calls the
commentThreads.listmethod with thevideoIdparameter set to retrieve comments for a video. - It calls the
comments.insertmethod with theparentIdparameter set to reply to an existing comment. - It calls the
comments.listmethod with theparentIdparameter to retrieve the comments in the thread. - It calls the
comments.updatemethod with comment in the request body to update a comment. - It calls the
comments.setModerationStatusmethod to set the moderation status of the comment, thecomments.markAsSpammethod to mark the comment as spam, and thecomments.deletemethod to delete the comment, using theidparameter to identify the comment.
Method: youtube.commentThreads.insert, youtube.commentThreads.list, youtube.commentThreads.update
Description: This sample demonstrates how to use the following API methods to create and manage top-level comments:
- It calls the
commentThreads.insertmethod once with thechannelIdparameter to create a channel comment and once with thevideoIdparameter to create a video comment. - It calls the
commentThreads.listmethod once with thechannelIdparameter to retrieve channel comments and once with thevideoIdparameter to retrieve video comments. - It calls the
commentThreads.updatemethod once to update a video comment and then again to update a channel comment. In each case, the request body contains thecommentresource being updated.
Method: youtube.captions.insert, youtube.captions.list, youtube.captions.update, youtube.captions.download,
youtube.captions.delete
Description: This sample demonstrates how to use the following API methods to create and manage YouTube video caption
tracks:
- It calls the
captions.insertmethod with theisDraftparameter set totrueto upload a caption track in draft status. - It calls the
captions.listmethod with thevideoIdparameter to retrieve video caption tracks. - It calls the
captions.updatemethod with the caption in the request body to update a caption track. - It calls the
captions.downloadmethod to download the caption track. - It calls the
captions.deletemethod to delete the caption track, using theidparameter to identify the caption track.
Method: youtube.videos.rate
Description: This sample calls the API's videos.rate method to set a positive rating for a video.
Method: youtube.activities.insert
Description: This sample calls the API's activities.insert method to post a bulletin to the channel
associated with the request.
Method: youtube.watermarks.unset
Description: This sample calls the API's watermarks.unset method to remove the watermark
image for a channel. The request must be authorized by the channel that owns the video.
Method: youtube.playlistItems.list
Description: This sample calls the API's playlistItems.list method to retrieve a list of videos uploaded
to the channel associated with the request. The code also calls the channels.list method with the
mine parameter set to true to retrieve the playlist ID that identifies the channel's uploaded
videos.
Method: youtube.search.list
Description: This sample calls the API's search.list method to retrieve search results associated with
a particular keyword.
Method: youtube.search.list, youtube.videos.list
Description: This sample calls the API's search.list method with the type,
q, location, and locationRadius parameters to retrieve search results
matching the provided keyword within the radius centered at a particular location. Using the video ids from
the search result, the sample calls the API's videos.list method to retrieve location details
of each video.
Method: youtube.channels.update, youtube.channels.list
Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
channel:
- It calls the
channels.updatemethod to update the default language of a channel's metadata and to add a localized version of this metadata in a selected language. Note that to set the default language for a channel resource, you actually need to update thebrandingSettings.channel.defaultLanguageproperty. - It calls the
channels.listmethod with thehlparameter set to a specific language to retrieve localized metadata in that language. - It calls the
channels.listmethod and includeslocalizationsin thepartparameter value to retrieve all of the localized metadata for that channel.
Method: youtube.channelSections.update, youtube.channelSections.list
Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
channel section:
- It calls the
channelSections.updatemethod to update the default language of a channel section's metadata and to add a localized version of this metadata in a selected language. - It calls the
channelSections.listmethod with thehlparameter set to a specific language to retrieve localized metadata in that language. - It calls the
channelSections.listmethod and includeslocalizationsin thepartparameter value to retrieve all of the localized metadata for that channel section.
Method: youtube.playlists.update, youtube.playlists.list
Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
playlist:
- It calls the
playlists.updatemethod to update the default language of a playlist's metadata and to add a localized version of this metadata in a selected language. - It calls the
playlists.listmethod with thehlparameter set to a specific language to retrieve localized metadata in that language. - It calls the
playlists.listmethod and includeslocalizationsin thepartparameter value to retrieve all of the localized metadata for that playlist.
Method: youtube.videos.update, youtube.videos.list
Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata
for a video:
- It calls the
videos.updatemethod to update the default language of a video's metadata and to add a localized version of this metadata in a selected language. - It calls the
videos.listmethod with thehlparameter set to a specific language to retrieve localized metadata in that language. - It calls the
videos.listmethod and includeslocalizationsin thepartparameter value to retrieve all of the localized metadata for that video.
Method: youtube.channelSections.list,youtube.channelSections.update
Description: This sample calls the API's channelSections.list method to get the list of current channel
sections. Then it shuffles the list and calls channelSections.update to change the position of each item.
More information on channel sections is available in the
YouTube Help Center.
Method: youtube.videos.update
Description: This sample calls the API's videos.update method to update a video owned by the channel
authorizing the request.
Method: youtube.channelBanners.insert, youtube.channels.update
Description: This sample calls the API's channelBanners.insert method to upload an image. With the
returned URL, the sample calls channels.update method to update the channel's banner to that image.
Method: youtube.videos.insert
Description: This sample calls the API's videos.insert method to upload a video to the channel associated
with the request.
Method: youtube.thumbnails.set
Description: This sample calls the API's thumbnails.set method to upload an image and set it as the
thumbnail image for a video. The request must be authorized by the channel that owns the video.
Method: youtube.watermarks.set
Description: This sample calls the API's watermarks.set method to upload an image and set it as the
watermark image for a channel. The request must be authorized by the channel that owns the video.
Method: youtube.liveBroadcasts.bind,youtube.liveBroadcasts.insert,youtube.liveStreams.insert
Description: This sample calls the API's liveBroadcasts.insert and liveStreams.insert
methods to create a broadcast and a stream. Then, it calls the liveBroadcasts.bind method to bind
the stream to the broadcast.
Method: youtube.liveBroadcasts.list
Description: This sample calls the API's liveBroadcasts.list method to retrieve a list of broadcasts for
the channel associated with the request. By default, the request retrieves all broadcasts for the channel, but you can
also specify a value for the --broadcast-status option to only retrieve broadcasts with a particular status.
Method: youtube.liveStreams.list
Description: This sample calls the API's liveStreams.list method to retrieve a list of video stream settings
that a channel can use to broadcast live events on YouTube.
Method: youtubeAnalytics.reports.query
Description: This sample calls the API's reports.query method to retrieve YouTube Analytics data.
By default, the report retrieves the top 10 videos based on viewcounts, and it returns several metrics for those
videos, sorting the results in reverse order by viewcount. By setting command line parameters, you can use the
same code to retrieve other reports as well.
Method: youtubeReporting.reportTypes.list, youtubeReporting.jobs.create
Description: This sample demonstrates how to create a reporting job. It calls the reportTypes.list method
to retrieve a list of available report types. It then calls the jobs.create method to create a new reporting
job.
Method: youtubeReporting.jobs.list, youtubeReporting.reports.list
Description: This sample demonstrates how to retrieve reports created by a specific job. It calls the
jobs.list method to retrieve reporting jobs. It then calls the reports.list method with the
jobId parameter set to a specific job id to retrieve reports created by that job. Finally, the sample
prints out the download URL for each report.