> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube

> Publish videos, manage your channel, and answer comments from your agents.

![YouTube](https://mintcdn.com/ruby-ai/LyGmDUG1gNsMgHcI/branding/integrations/youtube.svg?fit=max\&auto=format\&n=LyGmDUG1gNsMgHcI\&q=85\&s=cd99b47f095f44e074c159a525b0a86a)

> [!NOTE]
>
> YouTube tools are in preview and enabled per workspace. If a tool is missing, use your Ruby support channel to request access.

Connect YouTube to let agents upload and publish videos, edit titles, descriptions, visibility and thumbnails, manage playlists and captions, update your channel page, and read, answer and moderate comments.

YouTube comes as three separate tools. Connect only the ones your agents need:

| Tool | What agents can do |
| - | - |
| YouTube | Publish and manage videos, playlists, captions, channel branding and comments |
| [YouTube Analytics](https://docs.ruby.ad/docs/user-documentation/agents/tools/youtube-analytics.md) | Report on performance, audience, retention and revenue, and download bulk reports |
| [YouTube Live](https://docs.ruby.ad/docs/user-documentation/agents/tools/youtube-live.md) | Schedule and run live streams, manage live chat and read Super Chats |

## Connect

1. As a workspace admin, go to **Spaces → Tools** and add **YouTube**, **YouTube Analytics** or **YouTube Live**.
2. Choose **Personal** authentication for each user's Google account, or **Workspace** to share the connecting admin's account.
3. Click **Connect**, sign in with the Google account that manages your YouTube channel, and review the permissions Google requests.
4. Complete the connection, then add the tool to the agents that need it. With Personal authentication, each user connects their own account when prompted.

Connect each tool separately. YouTube and YouTube Live request permission to manage YouTube content. YouTube Analytics requests read access to channel information, analytics and monetary reports. None of these tools requests access to Gmail or Google Drive.

## Tools

### Channel page

| Tool | Description | Asks before running |
| - | - | - |
| Get YouTube channel | Get a YouTube channel's profile and statistics: title, handle, description, subscribers, views, video count and uploads playlist. Defaults to the connected channel. | Runs automatically |
| Update YouTube channel | Update the connected YouTube channel's description, keywords, country, default language or trailer. | Asks every time |
| Set YouTube channel banner | Set the YouTube channel banner (header art) from a 16:9 JPEG or PNG image of at least 2048x1152 pixels, up to 6 MB. | Asks every time |
| Set YouTube watermark | Set the YouTube channel watermark (branding image shown on every video, linking to the channel) from a JPEG or PNG image. | Asks every time |
| Remove YouTube watermark | Remove the YouTube channel watermark from the channel's videos. | Asks every time |
| List YouTube channel sections | List the sections (shelves) of the connected YouTube channel's home page with their type, title, position, playlists and channels. | Runs automatically |
| Create YouTube channel section | Add a new section (shelf) to the YouTube channel home page, e.g. a playlist, recent uploads or featured channels. A channel has at most 10 sections. | Asks every time |
| Update YouTube channel section | Update a YouTube channel home page section: rename it, reorder it (position), or change its playlists or channels. | Asks every time |
| Delete YouTube channel section | Delete a section (shelf) from the YouTube channel home page. | Asks every time |

### Videos

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube videos | List the connected channel's uploaded YouTube videos, newest first, including private, unlisted and scheduled ones, with views, likes, comments and privacy. | Runs automatically |
| Get YouTube videos | Get YouTube videos by id: title, description, tags, duration, view count, like and comment counts, privacy, schedule and, for the channel's own videos, processing status. | Runs automatically |
| Search YouTube | Search YouTube for videos, channels or playlists by keyword, optionally only the connected channel's videos. | Runs automatically |
| List YouTube video categories | List the YouTube video categories (with ids) that can be assigned to videos in a region. | Runs automatically |
| Upload YouTube video | Upload a video to the YouTube channel from a conversation file or a public URL (up to 2 GB), with title, description, tags, category, visibility, optional schedule, playlist and custom thumbnail. | Asks every time |
| Update YouTube video | Update a YouTube video's title, description, tags, category, language, audience, license or embedding. Omitted fields keep their current value. Use Change YouTube video visibility to publish or change privacy. | Asks every time |
| Change YouTube video visibility | Change a YouTube video's visibility (public, unlisted or private), or schedule a private video to go public at a date-time. Publish videos only when the user asked to. | Asks every time |
| Set YouTube thumbnail | Set a custom thumbnail on a YouTube video from a JPEG or PNG image (up to 50 MB, 1280x720 recommended). | Asks every time |
| Delete YouTube video | Delete a YouTube video permanently. This can't be undone. | Asks every time |
| Rate YouTube video | Like or dislike a YouTube video as the connected channel, or remove the rating. | Asks once |

Upload a video from a file in the conversation or a public URL, up to 2 GB. Tell the agent the title, description and whether the video should be public, unlisted or private. To schedule publication, use a private video and give the date, time and time zone. Review the visibility before approving the upload or publication.

### Playlists

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube playlists | List YouTube playlists of the connected channel (or another channel) with title, visibility and video count. | Runs automatically |
| List YouTube playlist videos | List which videos are in a YouTube playlist, in order, with their playlist item ids and positions. | Runs automatically |
| Create YouTube playlist | Create a new YouTube playlist on the connected channel with a title, description and visibility. | Asks every time |
| Update YouTube playlist | Rename a YouTube playlist or update its description, language or visibility. | Asks every time |
| Delete YouTube playlist | Delete a YouTube playlist. The videos in it are not deleted. | Asks every time |
| Add video to YouTube playlist | Add a video to a YouTube playlist, at the end or at a given position. | Asks once |
| Move video in YouTube playlist | Move a video to another position in a manually sorted YouTube playlist. | Asks once |
| Remove video from YouTube playlist | Remove a video from a YouTube playlist. The video itself is not deleted. | Asks once |

### Comments

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube comments | List the latest YouTube comments (comment threads) on a video or across all the channel's videos, newest or most relevant first. Filter on comments held for review or likely spam to review the moderation queue. | Runs automatically |
| List YouTube comment replies | List the replies to a YouTube comment. | Runs automatically |
| Post YouTube comment | Post a new YouTube comment on a video as the connected channel. | Asks once |
| Reply to YouTube comment | Reply to a YouTube comment as the connected channel. | Asks once |
| Edit YouTube comment | Edit the text of a YouTube comment the connected channel wrote. | Asks once |
| Moderate YouTube comments | Approve (publish) YouTube comments held for review, or hold published comments for review. | Asks once |
| Reject YouTube comments | Remove (reject) YouTube comments, and their replies, from the channel's videos, optionally banning their authors from commenting. Rejected comments can't be republished. | Asks every time |
| Delete YouTube comment | Delete a YouTube comment the connected channel wrote. To remove someone else's comment, use Reject YouTube comments. | Asks every time |

### Captions

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube captions | List the caption (subtitle) tracks of a YouTube video with language, name, draft status and whether they are auto-generated. | Runs automatically |
| Download YouTube caption | Download the text of a caption (subtitle) track of one of the channel's YouTube videos, optionally machine-translated, as SRT, WebVTT, SBV, SCC or TTML. | Runs automatically |
| Upload YouTube caption | Add subtitles in a language (a caption track) to a YouTube video from timed caption text (SRT, WebVTT, ...) or a conversation file. | Asks every time |
| Update YouTube caption | Replace the content of a YouTube caption (subtitle) track and/or publish or unpublish it (draft status). | Asks every time |
| Delete YouTube caption | Delete a caption (subtitle) track from a YouTube video. | Asks every time |

### Subscriptions

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube subscriptions | List the YouTube channels the connected channel subscribes to. | Runs automatically |
| List YouTube subscribers | List the connected YouTube channel's subscribers who made their subscriptions public, most recent first. | Runs automatically |
| Subscribe to YouTube channel | Subscribe the connected YouTube channel to another channel. | Asks once |
| Unsubscribe from YouTube channel | Unsubscribe the connected YouTube channel from a channel. | Asks once |

## Asks before running

The tables show the default approvals. Your workspace's tool settings can change when approval is required.

| Value | Meaning |
| - | - |
| Runs automatically | The agent reads data without asking. |
| Asks once | The agent asks the first time. You can approve the action for good. |
| Asks every time | The agent asks you to approve each use. |

Connecting your Google account grants access to YouTube. Approving a tool action in chat is a separate step: review the proposed content and changes before approving. You can reject the action instead.

Publishing and editing videos, changing visibility, changing channel branding, creating or deleting playlists, changing captions, rejecting comments and deleting content ask every time. Comment replies, ratings, playlist membership and subscriptions ask once by default; they can still change public content after you approve them for good.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.