YouTube
Upload, find, update and rate YouTube videos, manage playlists and their videos, update your channel, and read, post or reply to comments.
Connect YouTube
- In the sidebar, open Connections and press Add connection.
- Type
youtubeand choose YouTube. - Press Sign in with Google.
- Choose your account in Google’s window and allow access.
You should see Signed in as and the account’s address.
You can also connect from a step: under Connection, press New.
What if it says “Google sign-in isn’t set up here”?
This installation has no Google app yet. An admin of the installation sees Set up Google sign-in instead, and sets it up once for everyone:
- In Google Cloud, create an OAuth client of type Web application, and turn on the API for YouTube.
- In GoRunner, copy the Redirect address to add in Google Cloud, and add it to the client.
- Paste the Client ID and Client secret, then press Save and sign in.
Publish the app in Google Cloud. An app left in Testing signs everyone out after 7 days.
Everyone else sees who to ask.
Can I use my own Google app?
Yes. In the sheet, open Use your own Google app and paste its Client ID and Client secret. Add the Redirect address to add in Google Cloud to your app first. The connection then signs in through your app instead of the installation’s.
Connections says how to sign in again, rename or delete it. In a product that embeds GoRunner, Add connection can be missing: then your provider makes connections for you.
Do things in YouTube
Add a YouTube step, choose a Resource, then an Operation. Choose a row to see its fields.
- VideoUpload · Get · Search · Update · Rate · Delete
- PlaylistCreate · Get · Get Many · Update · Delete
- Playlist ItemAdd · Get · Get Many · Delete
- ChannelGet · Get Many · Update · Upload Banner
- Video CategoryGet Many
- CommentGet Many · Create · Reply · Delete
To start a workflow from YouTube, use a Schedule, Webhook or Form trigger.
Later steps read a step’s output by its name: see Use data from earlier steps.
Limits
- A reply from YouTube can be up to 16 MB (a file download can have its own limit). A larger one fails the step; it is never cut short.
- When YouTube says to slow down (429), the step waits as long as it asks, if the step’s time allows. Otherwise it fails and says when to try again.
Not in your list? See When an app isn’t here.
For developers
In the API, which calls apps pieces, YouTube is pieceId: "youtube" with actionId: "youtube", set by resource and an operation_… field, such as operation_channel. Get an app returns every field.
It can change something outside the run (writes_external). See How versions and side effects work.
YouTube › Video
Upload
- Video File · Required
Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). Any format YouTube takes (MP4, MOV, WebM …).
- Title · Optional
The video's title (at most 100 characters). Required to upload; on Update, empty keeps it.
- Description · Optional
At most 5,000 bytes. On Update, empty keeps it.
- Tags · Optional
Separated by commas. On Update, these replace the video's tags; empty keeps them.
- Category · Optional
The video category. On Update, empty keeps it.
- Visibility · Optional
Who can watch it. A new upload is private unless you pick another; on Update, empty keeps it.
Options: Private, Unlisted, Public.
- Publish At · Optional
Make a private video public at this time. Only for a video that has never been public.
- Made for Kids · Optional
Your declaration under YouTube's rules for content made for children. Empty leaves it for YouTube Studio to ask.
Options: Yes, No.
- Allow Embedding · Optional
Whether other sites may embed it. Empty keeps YouTube's setting.
Options: Yes, No.
- Show Statistics · Optional
Whether the watch page shows its statistics. Empty keeps YouTube's setting.
Options: Yes, No.
- License · Optional
Empty keeps YouTube's setting.
Options: Standard YouTube license, Creative Commons – Attribution.
- Language · Optional
The language of the title and description (a BCP-47 code such as en or de-CH).
- Recording Date · Optional
When it was recorded.
- Notify Subscribers · Optional
Tell the channel's subscribers about the new video.
On by default.
Get and Delete
- Video · Required
The video's link or id.
Search
- Search Text · Optional
Words to search for. Search allows 100 calls a day per Google Cloud project (each page of 50 is one).
- Only My Videos · Optional
Search only the signed-in channel's videos (Duration and Type cannot be combined with it).
Off by default.
- Channel · Optional
Only videos of this channel (its id UC… or link).
- Published After · Optional
- Published Before · Optional
- Region · Optional
Results for viewers in this country (ISO 3166-1 alpha-2).
- Category · Optional
The video category. On Update, empty keeps it.
- Duration · Optional
Empty finds any length.
Options: Under 4 minutes, 4 to 20 minutes, Over 20 minutes.
- Type · Optional
Empty finds every kind.
Options: Show episodes, Movies.
- Order · Optional
Options: Best match, Newest first, Most viewed, Highest rated, Title (A–Z).
Default: Best match.
- Safe Search · Optional
Options: Off, Moderate, Strict.
Default: Moderate.
- Return All · Optional
Read every video, page by page (at most 250; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many videos to return (1–250).
Default: 25.
Shows when Return All is off.
Update
- Video · Required
The video's link or id.
- Title · Optional
The video's title (at most 100 characters). Required to upload; on Update, empty keeps it.
- Description · Optional
At most 5,000 bytes. On Update, empty keeps it.
- Tags · Optional
Separated by commas. On Update, these replace the video's tags; empty keeps them.
- Category · Optional
The video category. On Update, empty keeps it.
- Visibility · Optional
Who can watch it. A new upload is private unless you pick another; on Update, empty keeps it.
Options: Private, Unlisted, Public.
- Publish At · Optional
Make a private video public at this time. Only for a video that has never been public.
- Made for Kids · Optional
Your declaration under YouTube's rules for content made for children. Empty leaves it for YouTube Studio to ask.
Options: Yes, No.
- Allow Embedding · Optional
Whether other sites may embed it. Empty keeps YouTube's setting.
Options: Yes, No.
- Show Statistics · Optional
Whether the watch page shows its statistics. Empty keeps YouTube's setting.
Options: Yes, No.
- License · Optional
Empty keeps YouTube's setting.
Options: Standard YouTube license, Creative Commons – Attribution.
- Language · Optional
The language of the title and description (a BCP-47 code such as en or de-CH).
- Recording Date · Optional
When it was recorded.
Rate
- Video · Required
The video's link or id.
- Rating · Required
Options: Like, Dislike, Remove my rating.
Default: Like.
YouTube › Playlist
Create
- Title · Optional
The playlist's title (at most 150 characters). Required to create; on Update, empty keeps it.
- Description · Optional
At most 5,000 bytes. On Update, empty keeps it.
- Visibility · Optional
Who can see it. A new playlist is private unless you pick another; on Update, empty keeps it.
Options: Private, Unlisted, Public.
- Tags · Optional
Separated by commas. On Update, these replace the playlist's tags; empty keeps them.
- Language · Optional
The language of the title and description (a BCP-47 code).
Get and Delete
- Playlist · Required
The playlist.
Get Many
- Channel · Optional
Another channel's public playlists (its id UC… or link). Empty lists the signed-in channel's own, private ones included.
- Return All · Optional
Read every playlist, page by page (at most 1000; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many playlists to return (1–1000).
Default: 50.
Shows when Return All is off.
Update
- Playlist · Required
The playlist.
- Title · Optional
The playlist's title (at most 150 characters). Required to create; on Update, empty keeps it.
- Description · Optional
At most 5,000 bytes. On Update, empty keeps it.
- Visibility · Optional
Who can see it. A new playlist is private unless you pick another; on Update, empty keeps it.
Options: Private, Unlisted, Public.
- Tags · Optional
Separated by commas. On Update, these replace the playlist's tags; empty keeps them.
- Language · Optional
The language of the title and description (a BCP-47 code).
YouTube › Playlist Item
Add
- Playlist · Required
The playlist.
- Video · Required
The video's link or id.
- Position · Optional
Where it goes: 1 is first. Empty adds it at the end.
- Note · Optional
A note shown with the video in the playlist (at most 280 characters).
Get and Delete
- Playlist Item ID · Required
The item's id in the playlist (id in Get Many's items: not the video's id).
Get Many
- Playlist · Required
The playlist.
- Return All · Optional
Read every playlist item, page by page (at most 1000; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many playlist items to return (1–1000).
Default: 50.
Shows when Return All is off.
YouTube › Channel
Get
- Channel · Optional
The channel's id (UC…), @handle or link. Empty is the signed-in account's own channel.
Get Many
- Channel IDs · Optional
Channel ids (UC…), separated by commas. Empty, with no Username, lists the signed-in account's channels.
- Legacy Username · Optional
A channel's old YouTube username (not its @handle).
- Return All · Optional
Read every channel, page by page (at most 1000; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many channels to return (1–1000).
Default: 50.
Shows when Return All is off.
Update
- Description · Optional
The channel's description (at most 1,000 characters). Empty keeps it.
- Keywords · Optional
Separated by spaces; put a phrase in double quotes. Empty keeps them.
- Country · Optional
Where the channel is based (two letters). Empty keeps it.
- Language · Optional
The language of the channel's title and description. Empty keeps it.
- Trailer for New Visitors · Optional
The video (link or id) shown to visitors who have not subscribed. Empty keeps it.
Upload Banner
- Banner Image · Required
Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). JPEG or PNG, 16:9, at least 2048 × 1152 (2560 × 1440 recommended), at most 6 MB.
YouTube › Video Category
Get Many
- Region · Required
The country whose categories to list (two letters).
Default: US.
- Return All · Optional
Read every category, page by page (at most 100; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many categorys to return (1–100).
Default: 50.
Shows when Return All is off.
YouTube › Comment
Get Many
- Video · Required
The video's link or id.
- Order · Optional
Options: Newest first, Top comments.
Default: Newest first.
- Containing · Optional
Only comments holding these words.
- Return All · Optional
Read every comment thread, page by page (at most 1000; past that the step fails rather than stop early).
Off by default.
- Limit · Optional
How many comment threads to return (1–1000).
Default: 50.
Shows when Return All is off.
Create
- Video · Required
The video's link or id.
- Text · Required
The comment (at most 10,000 characters).
Reply
- Reply To · Required
The id of the comment (or comment thread) to reply to.
- Text · Required
The comment (at most 10,000 characters).
Delete
- Comment ID · Required
The comment's id. Only the comment's author, or the video's owner, can delete it.