Video

Video connects your flow to your YouTube channel to work with videos: upload a new video with its title, description and category, look up the details and statistics of one video, of your videos or of the most popular ones, give a video a “Like” or “Dislike”, change its details or delete it.

It is useful to publish videos produced by another process without opening YouTube Studio, or to follow your videos’ views and comments automatically.

When to use it

Upload the recording of every webinar to YouTube as soon as it is ready.
Save your videos’ views, likes and comments in a spreadsheet every week.
Look up the most popular videos of a category and country to inspire your content.
Make a video public on launch day by changing its privacy.
Delete the videos of a campaign that has ended.

Configuration

You need a Youtube API credential, which connects by signing in with your Google account. When you create it you must enter the Client ID and Client Secret of your own Google Cloud project. See Credentials.

Field	What it does
Credential (required)	The Youtube API credential used to access your channel.
Operation	What the component does. See Operations. Default: `Upload Video`.
Mode	Only in `Get Video`. Which videos to return: `ID` (one video), `Most Popular` (the most popular ones for a country and category), `My Ratings` (the ones you have rated) or `My Videos` (your most recent uploads). Default: `ID`.
Video ID	The video’s ID or link. Required in `Rate Video`, `Delete Video` and `Update Video`, and in `Get Video` with `ID`. It does not appear in `Upload Video`.
Title	The video title. Needed in `Upload Video`; also in `Update Video`.
Description	The video description. In `Upload Video` and `Update Video`.
Region	The country. It decides which categories appear in Category. Needed in `Upload Video`; also in `Update Video` and in `Get Video` with `Most Popular`.
Category	The video category, among those YouTube offers for the chosen country. Needed in `Upload Video`; also in `Update Video`. In `Get Video` with `Most Popular`, it filters by category.
Language	The video language. Needed in `Upload Video`; also in `Update Video`.
Binary	Only in `Upload Video`, where it is needed. The video file to upload. Connect it from a component that delivers files or pass the video’s link.
Rating	Only in `Rate Video`. `Like`, `Dislike` or `Clear` (removes your rating). Default: `Like`.
Get Rating	Only in `Get Video` with `My Ratings`. Returns the videos you rated with `Like` or with `Dislike`. Default: `Like`.

The Region, Category and Language lists load when you pick the credential.

Operations

Operation	What it does
`Upload Video`	Uploads a new video to your channel with the given details.
`Get Video`	Returns the details and statistics of the videos chosen in Mode.
`Rate Video`	Gives a video a “Like” or “Dislike”, or removes your rating.
`Delete Video`	Deletes a video from your channel.
`Update Video`	Changes a video’s title, description, category, language, tags, privacy and made-for-kids declaration. When you type the Video ID, the editor fills the fields with the video’s current details so you only change what you need.

Advanced options

Field	What it does
Privacy Status	Who can see the video: `Private` (only you), `Unlisted` (anyone with the link) or `Public` (everyone, and it shows in searches). In `Upload Video` and `Update Video`. Default: `Private`.
Tags	The video’s tags. In `Upload Video` and `Update Video`.
Make For Kids	Declares that the video is made for kids. In `Upload Video` and `Update Video`. Off by default.
Notify Subscribers	Only in `Upload Video` and with Privacy Status set to `Public`. Lets your subscribers know you have published the video. Off by default.
Max Results	In `Get Video` with `Most Popular` or `My Ratings`. The maximum number of videos to return. Default: 10.

Output

The Result output returns one item per video you worked with: its ID (id), its link (url), title, description, image, publication date, channel, tags, category and privacy. With Get Video it also includes the statistics: views (view_count), likes (like_count) and comments (comment_count). Rate Video and Delete Video return a confirmation.

You can connect the result to a spreadsheet, to an email component to share the link, or to an agent. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A training company uploads the recording of every webinar to YouTube.

When the recording is ready, the flow receives the video file and the webinar title.
Add Video with the Upload Video operation and connect the file to Binary.
Write the title in Title, choose Spain (ES) or the right country in Region, the Education category in Category and the language in Language.
Leave Privacy Status as Unlisted and send the url link from the result to the attendees.

Good practices

Upload videos as Private or Unlisted and review them before making them public.
In Update Video, check every field before running: the video ends up with the values they contain.
YouTube limits how many videos you can upload per day. If you reach the limit, the upload fails with a notice.

Playlist Item: adds the video to a playlist.
YouTube Transcripts: gets the spoken text of a video.
Channel: looks up your channel’s statistics.