Use youtube-analytics for read-only evidence from one explicitly selected owned channel. It reports requested dates, provider date availability, metric definitions, compatibility, source endpoint, and warnings without revenue or advertising scopes.
Evidence example
Method date: 2026-08-26. Source: the audience_retention manifest example and mocked provider response asserted in tests/unit/youtube-analytics.test.ts; this is a schema example, not live channel data or a customer result.
Input:
{"channel_id":"UC1234567890123456789012","video_id":"video-1","start_date":"2026-07-01","end_date":"2026-07-31"}Output: Representative schema example; channel and video identifiers are [redacted], while retention ratios follow the test fixture.
{"available":true,"channel_id":"UC[redacted]","video_id":"[redacted]","requested_dates":{"start_date":"2026-07-01","end_date":"2026-07-31"},"provider_date_availability":{"effective_window_provable":false},"rows":[{"elapsed_video_time_ratio":0,"audience_watch_ratio":1}],"source_endpoint":"https://youtubeanalytics.googleapis.com/v2/reports"}Limitations: Requested end dates are upper bounds, provider freshness may shorten the effective window, retention is available only for eligible owned videos, and fixed opportunity rules are sensitive to the returned top-row sample.
Permissions: A read-only YouTube Analytics connection for the exact owned channel is required; no monetary or advertising reporting scope is requested and the channel is never inferred from account membership.
Cost/latency: These skills are listed as free in the manifest, but YouTube quotas and account terms apply; provider and network latency varies and no response-time guarantee is stated.
Safe next action: Confirm the owned UC… channel ID, run channel_summary for a short date window, and inspect provider-availability warnings before comparing videos.
See what a connector can access and the YouTube Analytics tool.