YouTube integration

What it does

The YouTube integration lets your agency run a client's channel from TaskJuice instead of YouTube Studio. Connect the client's Google account once, then upload videos and set their thumbnails, update titles, descriptions and privacy, build playlists, reply to and moderate comments, and pull channel analytics into reports. Triggers start a workflow when a channel publishes a video, a video lands in a playlist, a search turns up a new match, someone comments, or a live stream starts.

Connect a YouTube account

1. In your workspace, open Apps, choose YouTube and click Connect account, or click Connect on any YouTube node in the workflow editor.
2. Sign in with the Google account that owns or manages the channel.
3. Grant the requested access. YouTube asks for permission to manage the channel's videos and playlists, to manage comments (Google's youtube.force-ssl scope), and to read YouTube Analytics.
4. You return to the workflow with the connection ready.

To revoke access, open Google Account permissions and remove TaskJuice.

Triggers

• New Video on Channel (Instant) fires when a channel publishes a video, using the channel's public feed. Where push delivery is enabled, YouTube notifies TaskJuice as soon as the video goes up; otherwise the feed is checked on your interval. It needs no connection and spends no YouTube API quota, so it is the one to use for watching a channel. Paste the feed URL https://www.youtube.com/feeds/videos.xml?channel_id= followed by the channel ID.
• New Video on Channel checks a channel with the YouTube search API. It counts against YouTube's limit of 100 searches per day, so prefer the instant trigger above.
• New Video in Playlist fires once per video added to a playlist after the workflow is published.
• New Video by Search fires when a newly published video matches a search query. It checks at most every 4 hours, because YouTube allows only 100 searches a day per project.
• New Comment on Video fires when someone posts a top-level comment on a video.
• New Comment on Channel fires when someone posts a top-level comment on any of a channel's videos.
• New Live Stream fires when one of the connected channel's broadcasts goes live, or when one is scheduled.

Each polling trigger emits one activation per check with the new records in items. Add a Loop node over items to handle each one.

Actions

Videos

• Upload Video uploads a video file with its title, description, tags, category and privacy. Privacy defaults to private.
• Get Video returns a video's details and statistics.
• Search Videos searches YouTube by keyword or channel.
• Update Video Details replaces a video's title, description, tags and category.
• Update Video Privacy sets a video to private, unlisted or public, or schedules it to go public.
• Set Video Thumbnail uploads a custom thumbnail.
• Rate Video likes or dislikes a video, or removes the rating.
• Delete Video permanently deletes a video.
• List Video Categories lists the categories you can assign in a region.

Playlists

• Create Playlist, Update Playlist, Get Playlist, List My Playlists and Delete Playlist manage the channel's playlists.
• Add Playlist Item, List Playlist Items, Get Playlist Item and Remove Video From Playlist manage what is in a playlist.

Channel

• Get Channel returns a channel's details.
• Update Channel Details sets the channel description, keywords, country, trailer and banner.
• Upload Channel Banner uploads a banner image and returns the URL to pass to Update Channel Details.

Comments

• List Video Comments and List Comment Replies read comments.
• Post Comment on Video and Reply to Comment post as the channel.
• Moderate Comment publishes, holds or rejects a comment, and can ban its author.
• Delete Comment deletes a comment the channel wrote.

Analytics

• Get Channel Analytics Report runs a YouTube Analytics report, such as daily views and watch time.

Known limitations

• Updates replace the whole section. YouTube overwrites every field in the part you update. If you leave a video's description or tags blank in Update Video Details, YouTube clears them. The same applies to Update Playlist and Update Channel Details. Map the current values from Get Video, Get Playlist or Get Channel for anything you are not changing.
• Daily quota. Each Google Cloud project gets 10,000 quota units a day, plus separate limits of 100 searches and 100 uploads a day. Reads cost 1 unit and most writes cost 50. When a limit runs out, YouTube returns 403 until the quota resets at midnight Pacific time.
• Unverified apps upload private videos only. Videos uploaded through a Google Cloud project that has not passed YouTube's API audit are locked to private.
• Long playlists. New Video in Playlist reads the first 250 items. YouTube adds new videos to the end of a playlist by default, so for longer playlists turn on the playlist's "Add new videos to top of playlist" setting.
• Instant push. Push delivery for New Video on Channel (Instant) is being rolled out. Until it reaches your environment, the trigger checks the feed on its interval instead. The feed lists a channel's 15 most recent videos.
• Captions, live-stream production, live chat, channel sections, memberships and subscriptions are not available as actions yet. Use the HTTP Request node with your YouTube connection for those.