This page lists reports that channel owners can retrieve with the YouTube Reporting API. Each report's `id`, as returned by the API's `reportTypes.list` method, is provided in the report description.

## Video reports

Video reports provide statistics for all user activity related to a channel's videos. For example, these reports contain the number of times that your videos were viewed.

### User activity

This report provides user activity statistics related to a channel and its videos.
The `id` for this report is `channel_basic_a3`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [comments](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#comments), [likes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#likes), [dislikes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#dislikes), [videos_added_to_playlists](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#videos_added_to_playlists), [videos_removed_from_playlists](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#videos_removed_from_playlists), [shares](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#shares), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [annotation_click_through_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_click_through_rate), [annotation_close_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_close_rate), [annotation_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_impressions), [annotation_clickable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clickable_impressions), [annotation_closable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closable_impressions), [annotation_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clicks), [annotation_closes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closes), [card_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_click_rate), [card_teaser_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_click_rate), [card_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_impressions), [card_teaser_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_impressions), [card_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_clicks), [card_teaser_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_clicks), [subscribers_gained](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#subscribers_gained), [subscribers_lost](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#subscribers_lost), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### User activity by province

This report provides user activity statistics for US states and the District of Columbia.

The `id` for this report is

`channel_province_a3`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [province_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#province_code) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [annotation_click_through_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_click_through_rate), [annotation_close_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_close_rate), [annotation_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_impressions), [annotation_clickable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clickable_impressions), [annotation_closable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closable_impressions), [annotation_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clicks), [annotation_closes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closes), [card_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_click_rate), [card_teaser_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_click_rate), [card_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_impressions), [card_teaser_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_impressions), [card_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_clicks), [card_teaser_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_clicks), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### Playback locations

This report provides statistics related to the type of page or application where video playbacks occurred.

The `id` for this report is

`channel_playback_location_a3`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [playback_location_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Playback_Location_Dimensions), [playback_location_detail](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playback_location_detail) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### Traffic sources


This report aggregates viewing statistics based on the manner in which viewers reached the channel's video content.

For example, it identifies the number of views that stemmed from a Google Search or from a link to a related video.

The `id` for this report is

`channel_traffic_source_a3`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [traffic_source_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Traffic_Source_Dimensions), [traffic_source_detail](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#traffic_source_detail) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### Device type and operating system

This report aggregates video viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of views that occurred on Android tablets or on Windows desktop devices.

The `id` for this report is

`channel_device_os_a3`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [device_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#device_type), [operating_system](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#operating_system) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### Viewer demographics

This report aggregates viewing statistics based on viewers' age group and gender.

The `id` for this report is

`channel_demographics_a1`
.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [age_group](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#age_group), [gender](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#gender) |
| Metrics: | [views_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views_percentage) |

### Content sharing by platform


This report provides statistics showing how frequently the channel's videos were shared on different social platforms.

The `id` for this report is

`channel_sharing_service_a2`
.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [sharing_service](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#sharing_service) |
| Metrics: | [shares](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#shares) |

### Annotations


This report provides statistics for annotations that display during a channel's videos.


The report data measures the performance of individual annotations for each video. The [user activity report](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#video-user-activity), by contrast, aggregates statistics for all of a video's annotations.

The `id` for this report is

`channel_annotations_a2`
.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [annotation_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#annotation_type), [annotation_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#annotation_id) |
| Metrics: | [annotation_click_through_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_click_through_rate), [annotation_close_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_close_rate), [annotation_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_impressions), [annotation_clickable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clickable_impressions), [annotation_closable_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closable_impressions), [annotation_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_clicks), [annotation_closes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#annotation_closes) |

### Cards


This report provides impressions and click-through statistics for [cards](https://support.google.com/youtube/answer/6140493?ref_topic=6140492&rd=1) that display during a channel's videos.

The report data measures the performance of individual cards. The [user activity report](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#video-user-activity), by contrast, aggregates statistics for all of a video's cards.

The `id` for this report is

`channel_cards_a1`
.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [card_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#card_type), [card_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#card_id) |
| Metrics: | [card_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_click_rate), [card_teaser_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_click_rate), [card_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_impressions), [card_teaser_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_impressions), [card_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_clicks), [card_teaser_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#card_teaser_clicks) |

### End screens

This report provides impression and click-through statistics for end screens that display after a video stops playing.


The report contains statistics for a channel's videos.

The `id` for this report is

`channel_end_screens_a2`

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [end_screen_element_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#end_screen_element_type), [end_screen_element_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#end_screen_element_id) |
| Metrics: | [end_screen_element_clicks](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#end_screen_element_clicks), [end_screen_element_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#end_screen_element_impressions), [end_screen_element_click_rate](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#end_screen_element_click_rate) |

### Subtitles

This report provides statistics about the closed caption language that is used for the longest time during video views. Views in which captions are mostly turned off are excluded.
The `id` for this report is `channel_subtitles_a3`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [subtitle_language](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subtitle_language), [subtitle_language_autotranslated](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subtitle_language_autotranslated) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

### Combined

This report provides fine-grained video statistics by combining dimensions used in the [playback location](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#video-playback-locations), [traffic source](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#video-traffic-sources), and [device/OS](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#video-device-type-and-operating-system) reports.
The `id` for this report is `channel_combined_a3`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [playback_location_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Playback_Location_Dimensions), [traffic_source_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Traffic_Source_Dimensions), [device_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#device_type), [operating_system](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#operating_system) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [average_view_duration_percentage](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_percentage), [red_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_views), [red_watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#red_watch_time_minutes) |

## Reach reports

Reach reports provide statistics for video thumbnail impressions and click-through rates.

### Reach basic

This report provides basic reach statistics for a channel's videos.

The `id` for this report is `channel_reach_basic_a1`.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id) |
| Metrics: | [video_thumbnail_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#video_thumbnail_impressions), [video_thumbnail_impressions_ctr](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#video_thumbnail_impressions_ctr) |

### Reach combined

This report provides reach statistics combined with traffic source and device dimensions.

The `id` for this report is `channel_reach_combined_a1`.

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [traffic_source_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Traffic_Source_Dimensions), [traffic_source_detail](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#traffic_source_detail), [operating_system](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#operating_system), [device_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#device_type) |
| Metrics: | [video_thumbnail_impressions](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#video_thumbnail_impressions), [video_thumbnail_impressions_ctr](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#video_thumbnail_impressions_ctr) |

## Playlist reports

Playlist reports provide statistics that are specifically related to video views that occur in the context of a playlist.

### User activity

This report provides statistics related to users' interactions with a channel's playlists.

The `id` for this report is `playlist_basic_a2`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |

### User activity by province

This report provides user activity statistics related to users' interactions with a channel's playlists for US states and the District of Columbia. The report is filtered to only include data if the [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code) dimension's value is `US`.

The `id` for this report is `playlist_province_a2`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [province_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#province_code) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |

### Playback locations

This report provides statistics related to the type of page or application where playlist playbacks occurred.

The `id` for this report is

`playlist_playback_location_a2`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [playback_location_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Playback_Location_Dimensions), [playback_location_detail](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playback_location_detail) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |

### Traffic sources

This report aggregates viewing statistics based on the manner in which viewers reached a channel's playlist videos. For example, this report identifies the number of views that stemmed from a Google Search or from a link to a related video.

The `id` for this report is `playlist_traffic_source_a2`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [traffic_source_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Traffic_Source_Dimensions), [traffic_source_detail](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#traffic_source_detail) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |

### Device type and operating system

This report aggregates playlist viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of views that occurred on Android tablets or on Windows desktop devices.

The `id` for this report is

`playlist_device_os_a2`
.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [device_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#device_type), [operating_system](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#operating_system) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |

### Combined

This report provides fine-grained playlist statistics by combining dimensions used in the [playback location](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#playlist-playback-locations), [traffic source](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#playlist-traffic-sources), and [device/OS](https://developers.google.com/youtube/reporting/v1/reports/channel_reports.md.txt#playlist-device-type-and-operating-system) reports.

The `id` for this report is `playlist_combined_a2`.

> [!NOTE]
> **Note:** The latest version of this report has the following differences from its previous version:
>
> - Adds the [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views) metric

| Property | Value |
|---|---|
| Dimensions: | [date](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#date), [channel_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#channel_id), [playlist_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#playlist_id), [video_id](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#video_id), [live_or_on_demand](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#live_or_on_demand), [subscribed_status](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#subscribed_status), [country_code](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#country_code), [playback_location_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Playback_Location_Dimensions), [traffic_source_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#Traffic_Source_Dimensions), [device_type](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#device_type), [operating_system](https://developers.google.com/youtube/reporting/v1/reports/dimensions.md.txt#operating_system) |
| Metrics: | [engaged_views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#engaged_views), [views](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#views), [watch_time_minutes](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#watch_time_minutes), [average_view_duration_seconds](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#average_view_duration_seconds), [playlist_starts](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_starts), [playlist_saves_added](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_added), [playlist_saves_removed](https://developers.google.com/youtube/reporting/v1/reports/metrics.md.txt#playlist_saves_removed) |