Assistant tools · Reporting

YouTube tools

Channel overview, top videos, traffic sources, subscriber trend and comparison with Google Ads. Read only.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools7 tools

youtube_channels

קריאה1 credits

YouTube channels of the connected Google account: channel id, title, custom URL, subscribers, total views and video count. Read only.

This tool takes no parameters.

youtube_channel_overview

קריאה1 credits

Channel(s) of the connected account with subscribers, total views, video count, plus views, watch time, average view duration and subscriber change for the period versus the previous period. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)

youtube_top_videos

קריאה1 credits

Top videos of the period ranked by watch time (default) or views, with average view duration and percentage. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)
`by`Optional	watch_time \| views	—
`limit`Optional	integer (1–200)	—

youtube_traffic_sources

קריאה1 credits

How viewers found the channel or one video: YouTube search, suggested videos, external sites, playlists, subscriptions, ads… with share of views and organic vs paid split. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)
`video_id`Optional	string	—
`top_video`Optional	boolean	analyse the most viewed video of the period

youtube_subscriber_trend

קריאה1 credits

Subscribers gained/lost per week (and per day on request) over the period; with since=date compares the daily average before and after a campaign start. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)
`since`Optional	string	campaign start date YYYY-MM-DD to compare before/after
`daily`Optional	boolean	—

youtube_high_retention_videos

קריאה2 credits

Videos with few views but high average view percentage (above the channel median): candidates to replicate or promote. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)
`min_views`Optional	integer	—
`limit`Optional	integer (1–50)	—

youtube_vs_google_ads

קריאה2 credits

Organic YouTube views and watch time versus Google Ads VIDEO campaign spend and paid views for the same period. Each source reports honestly if not connected. Read only.

Parameter	Type	Description
`days`Optional	integer (1–730)	—
`start`Optional	string	YYYY-MM-DD
`end`Optional	string	YYYY-MM-DD
`channel`Optional	string	channel id (UC…) owned by the connected account; omit for the default channel (youtube_channels lists them)

Write tools1 tools

connect_youtube

כתיבה0 credits

Start connecting YouTube (read-only channel and video analytics): returns a one-time authorisation link the user opens (same flow as connect_account). Nothing is connected until the user signs in.

This tool takes no parameters.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.