Playlist

Playlist connects your flow to your YouTube channel to manage playlists: see your playlists or the details of one, create a new playlist, change its title, description, language or privacy, and delete it.

It is useful to organize your videos into collections automatically, for example to open a playlist for every course, event or content season.

When to use it

• Create a playlist for every new course or video series.
• Make a playlist public when a launch is ready.
• Check how many videos each playlist has for a content report.
• Delete the playlists of campaigns that have 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: Get Playlists.
Playlist ID	The playlist’s ID or link. Required in Delete Playlist and Update Playlist. In Get Playlists it is optional: if you leave it empty, you get your playlists. It does not appear in Create Playlist.
Max Results	Only in Get Playlists. The maximum number of playlists returned when you don’t give a Playlist ID. Default: 10.
Select Update	Only in Update Playlist. Which detail to change: Playlist Title, Playlist Description, Playlist Default Language or Playlist Privacy Status. The matching field appears depending on your choice. Default: Playlist Title.
Title	The playlist title. Needed in Create Playlist; in Update Playlist, with Playlist Title.
Description	The playlist description. In Create Playlist; in Update Playlist, with Playlist Description.
Privacy Status	Who can see the playlist: Private (only you), Unlisted (anyone with the link) or Public (everyone). In Create Playlist; in Update Playlist, with Playlist Privacy Status. Default: Private.
Language	The playlist’s default language. Once you pick the credential, the list shows the languages YouTube offers. In Create Playlist; in Update Playlist, with Playlist Default Language.

Operations

Operation	What it does
Get Playlists	Returns one playlist or the playlists of your channel.
Create Playlist	Creates a new playlist on your channel.
Delete Playlist	Deletes a playlist. The videos are not deleted.
Update Playlist	Changes the detail chosen in Select Update. The rest of the playlist information is kept.

Output

The Result output returns the playlists you worked with: their ID (id), title, description, image, creation date, language and privacy (privacy_status). With Get Playlists it also includes the number of videos (videos_count). Delete Playlist returns a confirmation.

You can use the playlist ID in Playlist Item to add videos to it. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A cooking school publishes a new course on YouTube every quarter.

1. When the course is registered in its system, the flow receives its name and description.
2. Add Playlist with the Create Playlist operation, the name in Title, the description in Description and Privacy Status set to Private.
3. Keep the playlist’s id to add the videos with Playlist Item.
4. On launch day, another flow uses Update Playlist with Playlist Privacy Status to set it to Public.

Good practices

• Create playlists as Private and make them public when they are complete.
• Keep the ID of every playlist you create: you need it to change it, delete it or add videos to it.

Related components

• Playlist Item: adds, orders and removes videos in a playlist.
• Video: uploads and manages videos.