---
title: "YouTube Analytics"
description: "Let a playbook query YouTube Analytics reports of a channel's views, watch time, audience, traffic sources and, in the Partner Program, estimated revenue."
url: "https://on.auto/integrations/youtube-analytics"
last_updated: "2026-11-10T08:19:38Z"
---

# YouTube Analytics

Query a channel's views, watch time, audience, traffic sources and estimated revenue.

A YouTube Analytics connection gives a playbook's functions the YouTube Analytics API, from a document Auto ships. You sign in to Google and allow YouTube Analytics, and the connection reads the reports of the channels your account owns or manages, including the revenue reports of a channel in the YouTube Partner Program.

Available on Auto Cloud and on self-hosted runtimes.

* * *

## What a playbook can do with YouTube Analytics

*   Query a report of views, watch time, average view duration, subscribers gained and lost, likes and comments, by day, video, country, traffic source, device and the other dimensions YouTube offers.
*   Query estimated revenue, ad revenue and monetized playbacks, for a channel in the Partner Program.

The connection reads only. To read a channel's videos and playlists or change a video, see [YouTube](https://on.auto/integrations/youtube).

The tools, as the connection lists them

Tools that read: `youtubeAnalytics.reports.query`.

* * *

## An example workflow

A release-week report for every new video. An event trigger starts the workflow when your agent, or a workflow with a [YouTube](https://on.auto/integrations/youtube) connection, records that a video went live. The workflow then waits seven days. A lookup function then queries the video's first week: views, watch time, average view duration and traffic sources by day. A computation function compares them with the channel's median first week, which the playbook keeps from earlier runs. A reasoning function reads the comparison with the team's notes on what a strong start looks like and writes two paragraphs: how the video did and where its viewers came from. An interaction function posts the report to the channel team through a Slack connection. The run's history in Studio keeps the rows, so the next video is compared with one more.

* * *

## How to connect YouTube Analytics

*   **Sign in to Google and allow YouTube Analytics.** The consent screen shows the permissions listed below.

Then:

1.  Ask your agent to connect YouTube Analytics to Auto, or open **Settings**, **Agents**, **Connections** in [Auto Studio](https://studio.on.auto/) and choose YouTube Analytics.
2.  On the Studio page, check the service and its access, choose which playbooks may use the connection, and approve it.
3.  Have your agent check one small read through the connection before a function depends on it.

* * *

## What it needs

*   A Google account that owns or manages the channel. Revenue reports answer only for a channel in the YouTube Partner Program.
*   Your agent connected to Auto and signed in as you, with permission to change your organization, if your agent adds the connection.
*   On a self-hosted runtime, a Google Cloud project of your own with the YouTube Analytics API enabled and an OAuth client registered for the runtime, as [Let people add connections](https://on.auto/docs/self-host/connections) sets out.

### Permissions Auto asks for

*   See YouTube Analytics reports for YouTube content.
*   See monetary and non-monetary YouTube Analytics reports for YouTube content.

* * *

## Good to know

YouTube Analytics finalizes a day's figures after a delay, as YouTube Studio does, so a report of yesterday may change by the day after. A report's rows are kept in the run's history, where people with access to the playbook can read them.

* * *

[All integrations](https://on.auto/integrations/) · [YouTube](https://on.auto/integrations/youtube) · [Google Analytics](https://on.auto/integrations/google-analytics) · [Buffer](https://on.auto/integrations/buffer) · [Bring in business data](https://on.auto/docs/cloud/connections) · [Give a function tools](https://on.auto/docs/guides/tools) · [Pricing](https://on.auto/pricing) · [YouTube Analytics documentation](https://developers.google.com/youtube/analytics)

## Sitemap

See the [full documentation and product sitemap](https://on.auto/sitemap.md) for related pages.