YouTube

YouTube has 11 operations in gum's generated catalog. Start with search when you know the task, use describe to inspect request fields and scopes, then dispatch through the command that matches the operation risk class.

Count	Value
Family	Search and media
Operations	11
Risk classes	2 destructive, 7 read, 2 write
Auth strategies	10 byo_oauth, 1 plugin_managed

Start here

bash

gum search "youtube"
gum describe youtube.channels.list
gum read youtube.channels.list --args '{"part":"<part>"}' --output json

For write-class operations, gum requires the write command and an explicit write gate:

bash

gum describe youtube.playlistItems.insert
gum write youtube.playlistItems.insert --allow-write --args '{"part":"<part>"}'

For destructive operations, run the call once for a confirmation envelope, review the target, then retry with the returned token:

bash

gum destructive youtube.playlistItems.delete --args '{"id":"<id>"}'
gum destructive youtube.playlistItems.delete --args '{"id":"<id>"}' --confirmed --token '<confirmation_token>'

Operations

Operation	Risk	Auth	Summary
`youtube.channels.list`	`read`	`byo_oauth`	Fetch channel resources by id, forUsername, or mine=true (part=snippet,statistics,contentDetails).
`youtube.playlistItems.delete`	`destructive`	`byo_oauth`	Remove an item from a playlist by id. Destructive — requires confirmation per §6.1.
`youtube.playlistItems.insert`	`write`	`byo_oauth`	Add a video to a playlist (part=snippet; args.body: snippet.playlistId, snippet.resourceId.videoId).
`youtube.playlistItems.list`	`read`	`byo_oauth`	Fetch the items of a playlist (part=snippet,contentDetails; playlistId or id).
`youtube.playlists.delete`	`destructive`	`byo_oauth`	Delete a playlist by id. Destructive — requires confirmation per §6.1.
`youtube.playlists.insert`	`write`	`byo_oauth`	Create a new playlist (part=snippet,status; args.body: snippet.title, status.privacyStatus).
`youtube.playlists.list`	`read`	`byo_oauth`	Fetch playlist resources by id, channelId, or mine=true (part=snippet,contentDetails).
`youtube.search.list`	`read`	`byo_oauth`	Search YouTube for videos, channels, and playlists (part=snippet; q, type, channelId, order, maxResults, …). Costs 100 quota units.
`youtube.subscriptions.list`	`read`	`byo_oauth`	Fetch subscription resources (part=snippet; mine=true or channelId).
`youtube.transcripts.get`	`read`	`plugin_managed`	Fetch the auto-generated or human-authored transcript for a YouTube video by video_id. Backed by the bundled youtube-transcripts Shape 1 plugin.
`youtube.videos.list`	`read`	`byo_oauth`	Fetch video resources by id (part=snippet,contentDetails,statistics) or chart=mostPopular.

Use API workflows for search, describe, invoke, and error handling.
Use Auth guides for service-specific Google setup.
Use Command index for CLI flags and generated help.

YouTube

Start here

Operations

Next