YouTube Analytics API: Content Owner Reports | YouTube Analytics and Reporting APIs

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/youtube/analytics/content_owner_reports"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/youtube/analytics/content_owner_reports" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/youtube/analytics/content_owner_reports" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/youtube/analytics/content_owner_reports?hl=vi" /><title>YouTube Analytics API: Content Owner Reports  |  YouTube Analytics and Reporting APIs  |  Google for Developers</title> <meta property="og:title" content="YouTube Analytics API: Content Owner Reports  |  YouTube Analytics and Reporting APIs  |  Google for Developers"><meta property="og:url" content="https://developers.google.com/youtube/analytics/content_owner_reports"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Analytics and Reporting APIs", "item": "https://developers.google.com/youtube/analytics" },{ "@type": "ListItem", "position": 3, "name": "YouTube Analytics API: Content Owner Reports", "item": "https://developers.google.com/youtube/analytics/content_owner_reports" }] } </script> {# Vars for auth docs %} <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="youtube-theme" type="reference" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Analytics and Reporting APIs" tenant-name="Google for Developers" project-scope="/youtube/analytics" url-scoped="https://developers.google.com/s/results/youtube/analytics" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developers.google.com/youtube/analytics" track-metadata-eventdetail="https://developers.google.com/youtube/analytics" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - home" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" > Home </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting" track-metadata-eventdetail="https://developers.google.com/youtube/reporting" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - overview" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" > Overview </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/guides/authorization" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/guides/authorization" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - authorization" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" > Authorization </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/reports" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/reports" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - bulk reports" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" > Bulk Reports </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/youtube/analytics/data_model" track-metadata-eventdetail="https://developers.google.com/youtube/analytics/data_model" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - targeted queries" track-metadata-module="primary nav" aria-label="Targeted Queries, selected" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" > Targeted Queries </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/code_samples" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/code_samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - resources" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" > Resources </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Upper header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/youtube/analytics" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Overview </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/guides/authorization" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Authorization" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Authorization </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/reports" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Bulk Reports" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Bulk Reports </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Targeted Queries" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Targeted Queries </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Resources </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>YouTube Analytics API</span> </div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Data Model</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/data_model" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/data_model" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/dimensions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/dimensions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/dimensions" ><span class="devsite-nav-text" tooltip>Dimensions</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/metrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/metrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/metrics" ><span class="devsite-nav-text" tooltip>Metrics</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/channel_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/channel_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/channel_reports" ><span class="devsite-nav-text" tooltip>Channel Reports</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/content_owner_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/content_owner_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/content_owner_reports" ><span class="devsite-nav-text" tooltip>Content Owner Reports</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Guides</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/sample-requests" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/sample-requests" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/sample-requests" ><span class="devsite-nav-text" tooltip>Sample requests</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>API Reference</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference/reports/query" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/reports/query" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/reports/query" ><span class="devsite-nav-text" tooltip>reports.query</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Groups</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/update" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/update" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/update" ><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>GroupItems</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/youtube/analytics/revision_history" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/revision_history" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/revision_history" ><span class="devsite-nav-text" tooltip>Revision History</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"><style> /* Styles inlined from /youtube/css/youtube_analytics_reports.css */ @media screen and (min-width: 1001px) { table.responsive.yt-analytics-report-details tr.yt-analytics-report-metrics { border-bottom: solid 3px #BDBDBD; border-top: solid 3px #BDBDBD; } table.responsive.yt-analytics-report-details tr.yt-analytics-report-sorting-options { border-top: solid 3px #BDBDBD; } table.responsive.yt-analytics-report-details td.yt-analytics-120-first-column table tr td:first-child { width: 120px; } } @media screen and (max-width: 1000px) { table.responsive.yt-analytics-report-details > tbody > tr:nth-of-type(n+3) { border-top: solid 3px #9E9E9E; } } table.responsive.yt-analytics-report-details td.yt-analytics-120-first-column td { border: 0; } </style><style> a.deprecated-metric { color: red; } </style> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics/data_model" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="" > Targeted Queries </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> YouTube Analytics API: Content Owner Reports </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <div itemscope itemtype="http://developers.google.com/ReferenceObject"> <meta itemprop="name" content="Content Owner Reports"/> <p class="note"><strong>Note:</strong> <span class="notranslate">Content owner reports are only accessible to YouTube content partners who participate in the <a href="http://www.youtube.com/yt/creators/partner.html">YouTube Partner Program</a>.</span></p> <p>This page lists reports that content owners can retrieve with the YouTube Analytics API. Content owner reports contain metrics for channels linked to a specified YouTube content owner. Metrics are individual measurements of user activity, ad performance, or estimated revenue.</p> <ul> <li> <p><a href="#video-reports">Video reports</a> contain user activity, ad performance, and estimated revenue metrics for videos on a content owner's channels.</p> </li> <li> <p><a href="#playlist-reports">Playlist reports</a> provide statistics that are specifically related to video views that occur in the context of a playlist. Playlist reports use many of the same dimensions and filters as video reports.</p> </li> <li> <p><a href="#ad-performance-reports">Ad performance reports</a> contain metrics related to revenue and ad performance. They use the <a href="/youtube/analytics/v1/dimsmets/dims#adType">adType</a> dimension to group metrics based on the types of ads that ran during video playbacks. The <a href="#Ad_Performance_Reports">ad performance reports</a> section explains the two types of ad performance metrics that the API supports.</p> </li> </ul> <h2 id="retrieving-a-report" data-text="Retrieving a report" tabindex="-1">Retrieving a report</h2> <p>To retrieve a content owner report, call the API's <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/reference/reports/query">reports.query</a></code> method and set the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#Parameters">ids</a></code> parameter value in the API request to <code translate="no" dir="ltr">contentOwner==<strong>OWNER_NAME</strong></code>, where <code translate="no" dir="ltr"><strong>OWNER_NAME</strong></code> specifies the content owner's ID. Ask your partner manager if you are unsure of the value.</p> <h3 id="Authorization" data-text="Authorization" tabindex="-1">Authorization</h3> <p>All YouTube Analytics API requests must be authorized. The <a href="/youtube/reporting/guides/authorization">Authorization guide</a> explains how to use the OAuth 2.0 protocol to retrieve authorization tokens.</p> <p>YouTube Analytics API requests use the following authorization scopes:</p> <table class="responsive"> <tr> <th colspan="2">Scopes</th> </tr> <tbody> <tr> <td>https://www.googleapis.com/auth/yt-analytics.readonly</td> <td>View YouTube Analytics reports for your YouTube content. This scope provides access to user activity metrics, like view counts and rating counts.</td> </tr> <tr> <td>https://www.googleapis.com/auth/yt-analytics-monetary.readonly</td> <td>View YouTube Analytics monetary reports for your YouTube content. This scope provides access to user activity metrics and to estimated revenue and ad performance metrics.</td> </tr> <tr> <td>https://www.googleapis.com/auth/youtube</td> <td>Manage your YouTube account. In the YouTube Analytics API, channel owners use this scope to manage YouTube Analytics groups and group items.</td> </tr> <tr> <td>https://www.googleapis.com/auth/youtubepartner</td> <td>View and manage YouTube assets and associated content on YouTube. In the YouTube Analytics API, content owners use this scope to manage YouTube Analytics groups and group items.</td> </tr> </tbody> </table> <p class="note"><strong>Note:</strong> Metrics that are marked with an asterisk (<code translate="no" dir="ltr">*</code>) require an authorization token that grants access to the <code translate="no" dir="ltr">https://www.googleapis.com/auth/yt-analytics-monetary.readonly</code> scope.</p> <h3 id="Filters" data-text="Filters" tabindex="-1">Filters</h3> <p>All API requests to retrieve content owner reports must filter data using either the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></code> dimension, the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></code> dimension, the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a></code> dimension, or a supported combination of the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></code> and <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a></code> dimensions. (Supported combinations are listed in the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a></code> dimension's definition.)</p> <p>The tables that explain the supported reports identify the filters that can be used for any given report. In the descriptions, filters shown in parentheses are optional. For example, if a report lists <code translate="no" dir="ltr">video(,country)</code> as a filtering option, then the report could either be filtered to only include data for a specific video or to only include data for a specific video in a specific country.</p> <p>The API also supports the ability to specify multiple values for the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></code>, <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a></code>, and <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></code> filters. If you do specify multiple values for one of these filters, you can also add that filter to the list of dimensions that you specify for the request. This is true even if the filter is not listed as a supported dimension for a particular report.</p> <p>See the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> parameter definition for a complete explanation of how to filter API results for a specific value or set of values.</p> <h3 id="understanding-report-tables" data-text="Understanding report tables" tabindex="-1">Understanding report tables</h3> <p>This section explains the formatting and terminology used in the tables that define reports that the API supports. The following table lists the dimensions, metrics, and filters supported for the playback details video report using the time dimension and the <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <p>The table contains two rows for dimensions, one row for metrics, and three rows for filters. For dimensions and filters, values from each row can be combined in an API request as long as the combination follows the usage rules in the table. So, for example, valid <code translate="no" dir="ltr">dimensions</code> parameter values for this report include:</p> <ul> <li><code translate="no" dir="ltr">dimensions=day</code></li> <li><code translate="no" dir="ltr">dimensions=day,subscribedStatus</code></li> <li><code translate="no" dir="ltr">dimensions=month,subscribedStatus,youtubeProduct</code></li> <li><code translate="no" dir="ltr">dimensions=month,youtubeProduct</code></li> </ul> <p>However, the parameter value <code translate="no" dir="ltr">day,month</code> is invalid because it uses two time-based dimensions, and the request must use either 0 or 1.</p> <h4 id="report-table-terminology" data-text="Report table terminology" tabindex="-1">Report table terminology</h4> <p>Tables use the following terminology to indicate whether dimensions are required or optional:</p> <ul> <li>These terms mean a value is required: <ul> <li><b>Required:</b> You must include the value.</li> <li><b>Use exactly 1:</b> You must include one value from the group.</li> <li><b>Use 1 or more:</b> You can include any or all values from the group, but you must include at least one.</li> </ul> </li> <li>These terms mean a value is optional: <ul> <li><b>Optional:</b> You have the option of include the value.</li> <li><b>Use 0 or 1:</b> You have the option of including one value from the group.</li> <li><b>Use 0 or more:</b> You have the option of including any or all values from the group.</li> </ul> </li> </ul> <div class="note"><b>Important:</b> All API requests to retrieve content owner video reports must filter data using either the <a href="/youtube/analytics/v1/dimsmets/dims#video">video</a> dimension, the <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> dimension, the <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a> dimension, or a supported combination of the <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a> and <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> dimensions. (Some reports do not support all of those options.) The supported combinations, which are also listed in the <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> dimension's definition, are: <ul> <li><code translate="no" dir="ltr">uploaderType==self</code></li> <li><code translate="no" dir="ltr">claimedStatus==claimed</code></li> <li><code translate="no" dir="ltr">claimedStatus==claimed;uploaderType==self</code></li> <li><code translate="no" dir="ltr">claimedStatus==claimed;uploaderType==thirdParty</code></li> </ul> </div> <h2 id="video-reports" data-text="Video reports" tabindex="-1">Video reports</h2> <h3 id="basic-stats-reports" data-text="Basic stats" tabindex="-1">Basic stats</h3> <h4 id="basic-statistics-including-subscriber-counts" data-text="Basic statistics (including subscriber counts)" tabindex="-1">Basic statistics (including subscriber counts)</h4> <p>This report provides statistics related to user actions on all of a content owner's channels. You can filter the report to only return data for a specific video or country. It can also be used to only retrieve statistics for claimed content, including claimed content uploaded by the content owner, third parties, or both.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>[None]</td> <td class="notranslate"> </td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#comments">comments</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersGained">subscribersGained</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersLost">subscribersLost</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRevenue">estimatedRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue">estimatedAdRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue">estimatedRedPartnerRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks">monetizedPlaybacks</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm">playbackBasedCpm</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a>*</td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> </table> <h4 id="basic-statistics-for-u.s.-states" data-text="Basic statistics for U.S. states" tabindex="-1">Basic statistics for U.S. states</h4> <p>This report provides statistics for a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>[None]</td> <td class="notranslate"> </td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> </table> </td> </tr> </table> <h3 id="time-based-reports" data-text="Time-based" tabindex="-1">Time-based</h3> <h4 id="activity-for-time-periods" data-text="Activity for time periods" tabindex="-1">Activity for time periods</h4> <p>This report provides statistics related to user actions on all of a content owner's channels for specific time intervals. You can filter the report to only return data for a specific video or country.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#comments">comments</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersGained">subscribersGained</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersLost">subscribersLost</a>, <a href="/youtube/analytics/v1/dimsmets/mets#uniques">uniques</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRevenue">estimatedRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue">estimatedAdRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue">estimatedRedPartnerRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks">monetizedPlaybacks</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm">playbackBasedCpm</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a>*</td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> </table> <h4 id="user-activity-in-u.s.-states-for-specific-time-periods" data-text="User activity in U.S. states for specific time periods" tabindex="-1">User activity in U.S. states for specific time periods</h4> <p>This report provides statistics for a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> </table> </td> </tr> </table> <h3 id="geographic-reports" data-text="User geography" tabindex="-1">User geography</h3> <h4 id="user-activity-by-country" data-text="User activity by country" tabindex="-1">User activity by country</h4> <p>This report provides statistics related to user activity on a country-by-country basis for all of a content owner's channels. You can filter the report to only return data for a specific video or channel.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#comments">comments</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersGained">subscribersGained</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersLost">subscribersLost</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRevenue">estimatedRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue">estimatedAdRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue">estimatedRedPartnerRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks">monetizedPlaybacks</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm">playbackBasedCpm</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a>*</td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> </table> <h4 id="user-activity-by-province" data-text="User activity by province" tabindex="-1">User activity by province</h4> <p>This report provides user activity statistics for U.S. states and the District of Columbia. For this report, you must set the <code translate="no" dir="ltr">filters</code> parameter value to <code translate="no" dir="ltr">country==US</code>.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>==US</td> </tr> </table> </td> </tr> </table> <h4 id="user-activity-by-city-=-250-results" data-text="User activity by city (<= 250 results)" tabindex="-1">User activity by city <span style="color:#555">(<= 250 results)</span></h4> <p class="note"><strong>Note:</strong> This report requires you to set the <code translate="no" dir="ltr">maxResults</code> parameter to a integer value of <code translate="no" dir="ltr">250</code> or less. Unlike most other reports, this report also requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report provides user activity statistics by city.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#city">city</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a><br><br><b>Note:</b> If you include the <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a> dimension, you must also use the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>==US</code> filter.</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> <h3 id="playback-detail-reports" data-text="Playback details" tabindex="-1">Playback details</h3> <p>Playback detail reports provide statistics related to the following viewing attributes:</p> <ul> <li>Was the view of a live video broadcast or an on-demand video?</li> <li>Was the viewer subscribed to the channel that owns the video?</li> <li>On which YouTube product did the view occur?</li> </ul> <p>Technically, the playback detail dimensions that these reports support are all optional. If you do not include playback detail dimensions in your request, the returned report will actually be similar to one of the <a href="#basic-stats-reports">basic stats</a>, <a href="#time-based-reports">time-based</a>, or <a href="#geographic-reports">user geography</a> reports.</p> <p class="note"><b>Note:</b> The <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> dimension and filter cannot be used in conjunction with the <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric. As such, each of the following subsections lists two reports. One report supports the <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> dimension (and filter), while the other supports the <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric.</p> <h4 id="user-activity-by-subscribed-status" data-text="User activity by subscribed status" tabindex="-1">User activity by subscribed status</h4> <p>This report provides user activity metrics for subscribed and unsubscribed viewers. Statistics can be grouped by time period (<a href="/youtube/analytics/v1/dimsmets/dims#day">day</a> or <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a>), and the report can also be filtered by <a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, or <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a>.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <h4 id="user-activity-by-subscribed-status-for-provinces" data-text="User activity by subscribed status for provinces" tabindex="-1">User activity by subscribed status for provinces</h4> <p>This report provides user activity metrics for subscribed and unsubscribed viewers in U.S. states or the District of Columbia. This report supports fewer metrics than the previous report.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <h4 id="playback-details-with-optional-time-dimension" data-text="Playback details with optional time dimension" tabindex="-1">Playback details with optional time dimension</h4> <p>The time dimension – <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a> or <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a> – is optional for these reports because, regardless, you need to use the <code translate="no" dir="ltr">startDate</code> and <code translate="no" dir="ltr">endDate</code> request parameters to specify the date range that the report will cover. The dimension, if present, indicates that you want data in the report to be aggregated by day, month, etc.</p> <h5 id="playback-details-with-optional-time-dimension-and-liveorondemand-statistics" data-text="Playback details with optional time dimension and liveOrOnDemand statistics" tabindex="-1">Playback details with optional time dimension and <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> statistics</h5> <p>This report provides playback detail statistics for specific time intervals. It supports the <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> dimension (and filter).</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h5 id="playback-details-with-optional-time-dimension-and-averageviewpercentage-metric" data-text="Playback details with optional time dimension and averageViewPercentage metric" tabindex="-1">Playback details with optional time dimension and <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric</h5> <p>This report provides playback detail statistics for specific time intervals.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h4 id="playback-details-by-country" data-text="Playback details by country" tabindex="-1">Playback details by country</h4> <h5 id="playback-details-by-country-with-liveorondemand-statistics" data-text="Playback details by country with liveOrOnDemand statistics" tabindex="-1">Playback details by country with <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> statistics</h5> <p>This report provides playback detail statistics on a country-by-country basis. It supports the <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> dimension (and filter).</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h5 id="playback-details-by-country-with-averageviewpercentage-metric" data-text="Playback details by country with averageViewPercentage metric" tabindex="-1">Playback details by country with <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric</h5> <p>The following report is similar to the previous one. It adds support for the <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric, but it does not support <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> as a dimension or a filter.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h4 id="playback-details-by-province" data-text="Playback details by province" tabindex="-1">Playback details by province</h4> <h5 id="playback-details-by-province-with-liveorondemand-statistics" data-text="Playback details by province with liveOrOnDemand statistics" tabindex="-1">Playback details by province with <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> statistics</h5> <p>This report provides playback detail statistics for U.S. states and the District of Columbia. It supports the <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> dimension (and filter).</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a><code translate="no" dir="ltr">==US</code></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h5 id="playback-details-by-province-with-averageviewpercentage-metric" data-text="Playback details by province with averageViewPercentage metric" tabindex="-1">Playback details by province with <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric</h5> <p>The following report is similar to the previous one. It adds support for the <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a> metric, but it does not support <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a> as a dimension or a filter.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a><code translate="no" dir="ltr">==US</code></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h3 id="playback-location-reports" data-text="Playback locations" tabindex="-1">Playback locations</h3> <h4 id="video-playback-location-report" data-text="Video playback location report" tabindex="-1">Video playback location report</h4> <p>This report provides statistics related to the type of page or application where video playbacks occurred.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <h4 id="playback-location-detail-=-25-results" data-text="Playback location detail (<= 25 results)" tabindex="-1">Playback location detail <span style="color:#555">(<= 25 results)</span></h4> <p class="note"><strong>Note:</strong> This report requires you to set the <code translate="no" dir="ltr">maxResults</code> parameter to a integer value of <code translate="no" dir="ltr">25</code> or less. Unlike most other reports, this report also requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report identifies the embedded video players that generated the most views or viewing time for a content owner's content. When retrieving this report, you must set the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a></code> filter to <code translate="no" dir="ltr">EMBEDDED</code>.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightPlaybackLocationDetail">insightPlaybackLocationDetail</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a>==EMBEDDED</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> <h3 id="traffic-source-reports" data-text="Traffic sources" tabindex="-1">Traffic sources</h3> <h4 id="traffic-source" data-text="Traffic source" tabindex="-1">Traffic source</h4> <p>This report aggregates viewing statistics based on the manner in which viewers reached your video content. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video.</p> <p class="note"><strong>Note:</strong> This report returns an error if the product of <b># of queried videos</b> X <b># of days in date range</b> exceeds 50,000. For example, a query that retrieves data for 500 video IDs can request data for a maximum of 100 days. To reduce the number of rows that a request returns, split your query into multiple queries that specify fewer videos or set shorter date ranges.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <h4 id="traffic-source-detail-=-25-results" data-text="Traffic source detail (<= 25 results)" tabindex="-1">Traffic source detail <span style="color:#555">(<= 25 results)</span></h4> <p class="note"><strong>Note:</strong> This report requires you to set the <code translate="no" dir="ltr">maxResults</code> parameter to a integer value of <code translate="no" dir="ltr">25</code> or less. Unlike most other reports, this report also requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report aggregates viewing statistics based on the referrers that generated the most views for the content owner's content. Referrers are categorized by traffic source type, and the <a href="/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail">insightTrafficSourceDetail</a> dimension's definition identifies the traffic sources for which the report is available. For example, if you set the <a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a> filter to <code translate="no" dir="ltr">ADVERTISING</code>, the report will list the types of ads that generated the most views or viewing time for the content owner's content.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail">insightTrafficSourceDetail</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a> (see note below table)</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> <p class="note"><strong>Note:</strong> This report is only supported for specific traffic sources. <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, <code translate="no" dir="ltr"><strong>NOTIFICATION</strong></code>, <code translate="no" dir="ltr"><strong>END_SCREEN</strong></code>, <code translate="no" dir="ltr"><strong>CAMPAIGN_CARD</strong></code>, <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, and <code translate="no" dir="ltr"><strong>NO_LINK_EMBEDDED</strong></code> traffic sources are some of the unsupported ones.</p> <h3 id="device-os-reports" data-text="Device type and operating system" tabindex="-1">Device type and operating system</h3> <h4 id="device-type" data-text="Device type" tabindex="-1">Device type</h4> <p>This report aggregates viewing statistics based on the type of device that viewers were using when watching your content. For example, it identifies the number of views that occurred on tablets or game consoles.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h4 id="operating-system" data-text="Operating system" tabindex="-1">Operating system</h4> <p>This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of views that occurred on Android devices or on PlayStations.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h4 id="operating-system-and-device-type" data-text="Operating system and device type" tabindex="-1">Operating system and device type</h4> <p>This report aggregates 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.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a>,<a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h3 id="demographic-reports" data-text="Viewer demographics" tabindex="-1">Viewer demographics</h3> <p>This report aggregates viewing statistics based on viewers' age group and gender.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#ageGroup">ageGroup</a>, <a href="/youtube/analytics/v1/dimsmets/dims#gender">gender</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <div class="note"><b>Note:</b> The <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> values in this report are not normalized for different values of the <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a> playback detail dimension.<br><br>For example, if a report uses the <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a> dimension, then it returns <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data adding up to 100 percent for subscribed views <em>and</em> <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data adding up to 100 percent for unsubscribed views. (The total value of all <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> fields in the report is 200 percent.)<br><br>You can use filters to ensure that the report only contains <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data for one value of the <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a> dimension.</div> <h3 id="social-reports" data-text="Engagement and content sharing" tabindex="-1">Engagement and content sharing</h3> <p>This report provides statistics showing how frequently the channel's videos were shared on different social platforms.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#sharingService">sharingService</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> <h3 id="audience-retention-reports" data-text="Audience retention" tabindex="-1">Audience retention</h3> <p>This report measures a video's ability to retain its audience. The <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></code> dimension measures the amount of the video that has elapsed for the corresponding metric values. The <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/mets#audienceWatchRatio">audienceWatchRatio</a></code> and <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/mets#relativeRetentionPerformance">relativeRetentionPerformance</a></code> metrics provide two measurements that show how well the video retains its audience. The first is an absolute value, while the second shows how the video performs relative to other YouTube videos of a similar length.</p> <p class="note"><strong>Note:</strong> Audience retention reports do not support the ability to specify a comma-separated list of values for the <code translate="no" dir="ltr">video</code> filter; the value must specify a single video ID.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#audienceWatchRatio">audienceWatchRatio</a>, <a href="/youtube/analytics/v1/dimsmets/mets#relativeRetentionPerformance">relativeRetentionPerformance</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#audienceType">audienceType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> <h3 id="top-videos-reports" data-text="Top videos" tabindex="-1">Top videos</h3> <p class="note"><strong>Note:</strong> These reports require you to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">200</code> or less. Before January 1, 2013 data is only available for the top 10 videos. Unlike most other reports, these reports also require you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <h4 id="top-videos-overall,-by-country,-by-continent,-or-by-subcontinent-=-200-results" data-text="Top videos overall, by country, by continent, or by subcontinent (<= 200 results)" tabindex="-1">Top videos overall, by country, by continent, or by subcontinent <span style="color:#555">(<= 200 results)</span></h4> <p>This report lists the content owner's top videos based on the specified filtering and sorting criteria.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#comments">comments</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersGained">subscribersGained</a>, <a href="/youtube/analytics/v1/dimsmets/mets#subscribersLost">subscribersLost</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRevenue">estimatedRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue">estimatedAdRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue">estimatedRedPartnerRevenue</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks">monetizedPlaybacks</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm">playbackBasedCpm</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a>*, <a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a>*</td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRevenue">estimatedRevenue</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue">estimatedRedPartnerRevenue</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#subscribersGained">subscribersGained</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#subscribersLost">subscribersLost</a></td> </tr> </table> <h4 id="top-videos-overall-by-u.s.-state-=-200-results" data-text="Top videos overall by U.S. state (<= 200 results)" tabindex="-1">Top videos overall by U.S. state <span style="color:#555">(<= 200 results)</span></h4> <p>This report lists the content owner's top videos in a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a></td> </tr> </table> <h4 id="top-videos-for-subscribed-or-unsubscribed-viewers=-200-results" data-text="Top videos for subscribed or unsubscribed viewers(<= 200 results)" tabindex="-1">Top videos for subscribed or unsubscribed viewers<span style="color:#555">(<= 200 results)</span></h4> <p>This report lists the top videos for subscribed or unsubscribed viewers. The report can be filtered to list top videos by <a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, or <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a>. The previous report lets you retrieve the top videos in a particular U.S. state for subscribed or unsubscribed viewers, but it supports fewer metrics than this report.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#likes">likes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#dislikes">dislikes</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists">videosAddedToPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists">videosRemovedFromPlaylists</a>, <a href="/youtube/analytics/v1/dimsmets/mets#shares">shares</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate">annotationClickThroughRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloseRate">annotationCloseRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationImpressions">annotationImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions">annotationClickableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions">annotationClosableImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationClicks">annotationClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#annotationCloses">annotationCloses</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClickRate">cardClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate">cardTeaserClickRate</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardImpressions">cardImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions">cardTeaserImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardClicks">cardClicks</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks">cardTeaserClicks</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a></td> </tr> </table> <h4 id="top-videos-by-youtube-product-=-200-results" data-text="Top videos by YouTube Product (<= 200 results)" tabindex="-1">Top videos by YouTube Product <span style="color:#555">(<= 200 results)</span></h4> <p>This report lists top videos and supports playback detail and geographic filters. This report is similar to the previous one, but it supports fewer metrics and adds support for the <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a> filter.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a></td> </tr> </table> <h4 id="top-videos-with-playback-detail-filters-=-200-results" data-text="Top videos with playback detail filters (<= 200 results)" tabindex="-1">Top videos with playback detail filters <span style="color:#555">(<= 200 results)</span></h4> <p>This report lists the content owner's top videos, filtering by one or more playback detail dimensions: <a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, and <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a>. The report also supports filtering by region.</p> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a> or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand">liveOrOnDemand</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a></td> </tr> </table> <h2 id="playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h2> <p>Playlist reports contain metrics related to user activity related to videos in the channel owner's playlists. Two versions of these reports are available, and, for each available report, the following sections contain a description of each version:</p> <ul> <li>The <b>Recommended</b> tab in each section describes the preferred API request format for retrieving the corresponding report. The recommended reports support an expanded set of metrics that includes both <a href="#aggregated-video-metrics">aggregated video metrics</a> and <a href="#in-playlist-metrics">in-playlist metrics</a>. This request format does not use the <code translate="no" dir="ltr">isCurated</code> dimension.</li> <li>The <b>Using <code translate="no" dir="ltr">isCurated</code></b> tab in each section describes an older API request format in which the <code translate="no" dir="ltr">isCurated</code> dimension is required. These reports support <a href="#in-playlist-metrics">in-playlist metrics</a> only. Note that the <code translate="no" dir="ltr">isCurated</code> dimension has been deprecated for all reports. The warning note below explains the deprecation schedule.</li> </ul> <p>The following warning note explains changes between the two report versions in more detail.</p> <aside class="warning"> <b>Important:</b> Update playlist reports for channels before June 30, 2024, and update playlist reports for content owners by December 31, 2024. Please note the following changes: <ul> <li>The <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#isCurated">isCurated</a></code> dimension has been deprecated. <ul> <li><b>For channel reports</b>, this dimension will no longer be supported on or after June 30, 2024.</li> <li><b>For content owner reports</b>, this dimension will no longer be supported on or after December 31, 2024.</li> </ul> </li> <li>The behavior of the <code translate="no" dir="ltr"><a href="/youtube/analytics/views#views">views</a></code> metric changes when you remove the <code translate="no" dir="ltr">isCurated</code> dimension from a request to retrieve a playlist report: <ul> <li>When a request includes the <code translate="no" dir="ltr">isCurated</code> dimension, the <code translate="no" dir="ltr"><a href="/youtube/analytics/views#views">views</a></code> metric indicates the number of times that the video was viewed in the context of the playlist.</li> <li>When a request does not include the <code translate="no" dir="ltr">isCurated</code> dimension, the <code translate="no" dir="ltr">views</code> metric specifies the total number of times that the video was viewed, while the <code translate="no" dir="ltr">playlistViews</code> metric indicates the number of times that the video was viewed in the context of the playlist.</li> </ul> </li> </ul> As a result, to preserve backward compatibility when you remove the <code translate="no" dir="ltr">isCurated</code> dimension, you must also update your code to retrieve the <code translate="no" dir="ltr">playlistViews</code> metric instead of the <code translate="no" dir="ltr">views</code> metric for playlist reports only. Since the <code translate="no" dir="ltr">views</code> metric is still supported for playlist reports, albeit with a different meaning, the API will still return data if you do not update the metric name. Of course, you can modify your application to retrieve and display both <code translate="no" dir="ltr">views</code> and <code translate="no" dir="ltr">playlistViews</code>.<br><br> See the <a href="/youtube/analytics/revision_history">revision history</a> for more details. </aside> <h4 id="aggregated-video-metrics" data-text="Aggregated video metrics" tabindex="-1">Aggregated video metrics</h4> <p>These metrics provide user activity and impression metrics that are aggregated for all videos in the playlist that are also owned by the channel that owns the playlist. Metrics for videos owned by other channels are not computed in the aggregation. As a result, if a channel creates a playlist that contains only videos owned by other channels, reports for those playlists will not provide values for these metrics.</p> <p>See the <a href="#supported-playlist-metrics">supported playlist metrics</a> section for a list of aggregated video metrics that YouTube supports.</p> <h4 id="in-playlist-metrics" data-text="In-playlist metrics" tabindex="-1">In-playlist metrics</h4> <p>These metrics reflect user activity and engagement in the context of the playlist page. These metrics include views for all videos in the playlist, regardless of which channel owns them, but only counts views that occurred in the playlist context.</p> <h4 id="supported-playlist-metrics" data-text="Supported playlist metrics" tabindex="-1">Supported playlist metrics</h4> <aside class="special"><b>Important:</b> As shown in the tables below, the <code translate="no" dir="ltr"><a href="/youtube/analytics/metrics#views">views</a></code> metric provides different types of data in the two available versions of each playlist report. <ul> <li>In the <u>recommended</u> report format, <code translate="no" dir="ltr">views</code> is an aggregated video metric.</li> <li>In reports <u>retrieved using the <code translate="no" dir="ltr">isCurated</code> dimension</u>, <code translate="no" dir="ltr">views</code> is an in-playlist metric.</li> </ul> </aside> <section class="kd-tabbed-horz yt-reporting-api-section" id="playlist-metric-distinctions"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Aggregated video metrics</td> <td><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> <tr class="yt-analytics-report-metrics"> <td>in-playlist metrics</td> <td><a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Aggregated video metrics</td> <td><b>Not supported</td> </tr> <tr class="yt-analytics-report-metrics"> <td>in-playlist metrics</td> <td><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewPercentage">averageViewPercentage</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a> </td> </tr> </table> </article> </section> <h3 id="basic-stats-playlist-reports" data-text="Basic stats" tabindex="-1">Basic stats</h3> <p>This report provides statistics related to users' interactions with the videos in the playlists on a content owner's channels. The report does not have any required dimensions.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-basic-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>[None]</td> <td class="notranslate"> </td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <aside class="warning"> The <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#isCurated">isCurated</a></code> dimension has been deprecated and will no longer be supported for content owner reports on or after December 31, 2024. The <a href="/youtube/analytics/playlist_reports_migration_guide">Playlist reports migration guide</a> explains other changes you can or need to make in association with this deprecation. </aside> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>[None]</td> <td class="notranslate"> </td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h3 id="time-based-playlist-reports" data-text="Time-based" tabindex="-1">Time-based</h3> <p>This report provides statistics related to users' interactions with the videos in playlists for a content owner's channels over specific time intervals. You can filter the report to only return data for a specific playlist or channel.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-time-based-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h3 id="geographic-playlist-reports" data-text="User geography" tabindex="-1">User geography</h3> This report provides statistics related to interactions that users in a particular country have with the videos in the channel's playlists. <p>This report provides playlist statistics by country.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-geo-country-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h4 id="playlist-activity-by-province" data-text="Playlist activity by province" tabindex="-1">Playlist activity by province</h4> <p>This report provides playlist activity statistics for U.S. states and the District of Columbia. For this report, you include <code translate="no" dir="ltr">country==US</code> in the the <code translate="no" dir="ltr">filters</code> parameter value.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-geo-province-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a><code translate="no" dir="ltr">==US</code></td> </tr> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#province">province</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1;<a href="/youtube/analytics/v1/dimsmets/dims#country">country</a><code translate="no" dir="ltr">==US</code></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h3 id="playback-location-playlist-reports" data-text="Playback locations" tabindex="-1">Playback locations</h3> <p>This report provides statistics related to the type of page or application where playlist playbacks occurred.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-playback-location-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h4 id="playback-location-detail-=-25-results_1" data-text="Playback location detail (<= 25 results)" tabindex="-1">Playback location detail <span style="color:#555">(<= 25 results)</span></h4> <p class="note"><strong>Note:</strong> This report requires you to set the <code translate="no" dir="ltr">maxResults</code> parameter to a integer value of <code translate="no" dir="ltr">25</code> or less. Unlike most other reports, this report also requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report identifies the embedded video players that generated the most views or viewing time for a content owner's playlists.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-playback-location-detail-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightPlaybackLocationDetail">insightPlaybackLocationDetail</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a><code translate="no" dir="ltr">==EMBEDDED</code></td> </tr> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightPlaybackLocationDetail">insightPlaybackLocationDetail</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1;<a href="/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions">insightPlaybackLocationType</a><code translate="no" dir="ltr">==EMBEDDED</code></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> </section> <h3 id="traffic-source-playlist-reports" data-text="Traffic sources" tabindex="-1">Traffic sources</h3> <p>This report aggregates viewing statistics based on the manner in which viewers reached your playlist content. For example, it identifies the number of views that stemmed from a Google search or a channel page.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-traffic-source-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h4 id="traffic-source-detail-=-25-results_1" data-text="Traffic source detail (<= 25 results)" tabindex="-1">Traffic source detail <span style="color:#555">(<= 25 results)</span></h4> <p class="note"><strong>Note:</strong> This report requires you to set the <code translate="no" dir="ltr">maxResults</code> parameter to a integer value of <code translate="no" dir="ltr">25</code> or less. Unlike most other reports, this report also requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report aggregates viewing statistics based on the referrers that generated the most views for the content owner's playlists. Referrers are categorized by traffic source type, and the <a href="/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail">insightTrafficSourceDetail</a> dimension's definition identifies the traffic sources for which the report is available. For example, if you set the <a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a> filter to <code translate="no" dir="ltr">ADVERTISING</code>, the report will list the types of ads that generated the most views or viewing time for the content owner's playlists.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-traffic-source-detail-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail">insightTrafficSourceDetail</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a></td> </tr> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail">insightTrafficSourceDetail</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1;<a href="/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions">insightTrafficSourceType</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> </section> <p class="note"><strong>Note:</strong> This report is only supported for specific traffic sources. <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, <code translate="no" dir="ltr"><strong>NOTIFICATION</strong></code>, <code translate="no" dir="ltr"><strong>END_SCREEN</strong></code>, <code translate="no" dir="ltr"><strong>CAMPAIGN_CARD</strong></code>, <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, and <code translate="no" dir="ltr"><strong>NO_LINK_EMBEDDED</strong></code> traffic sources are some of the unsupported ones.</p> <h3 id="device-os-playlist-reports" data-text="Device type and operating system" tabindex="-1">Device type and operating system</h3> <h4 id="device-type-for-playlists" data-text="Device type for playlists" tabindex="-1">Device type for playlists</h4> <p>This report aggregates viewing statistics based on the device type that viewers used to watch your playlist content. For example, it identifies the number of views that occurred on mobile devices or game consoles.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-device-type-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h4 id="operating-system-for-playlists" data-text="Operating system for playlists" tabindex="-1">Operating system for playlists</h4> <p>This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of playlist views that occurred on Android devices or on PlayStations.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-operating-system-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h4 id="operating-system-and-device-type-for-playlists" data-text="Operating system and device type for playlists" tabindex="-1">Operating system and device type for playlists</h4> <p>This report aggregates viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of playlist views that occurred on Android tablets or on Windows desktop devices.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-device-type-os-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#deviceType">deviceType</a>, <a href="/youtube/analytics/v1/dimsmets/dims#operatingSystem">operatingSystem</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> </table> </article> </section> <h3 id="demographic-playlist-reports" data-text="Viewer demographics" tabindex="-1">Viewer demographics</h3> <p>This report aggregates viewing statistics based on viewers' age group and gender.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-viewer-demographics-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#ageGroup">ageGroup</a>, <a href="/youtube/analytics/v1/dimsmets/dims#gender">gender</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 0 or 1<sup>*</sup></td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a><br><br><b>Note:</b> Exactly one of these filters must be specified if any of the <a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, or <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a> metrics is requested in the report.</td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> </table> </td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#ageGroup">ageGroup</a>, <a href="/youtube/analytics/v1/dimsmets/dims#gender">gender</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a></td> </tr> </table> </td> </tr> </table> </article> </section> <div class="note"><b>Note:</b> The <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> values in this report are not normalized for different values or combinations of values for playback detail dimensions (<a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a> and <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a>).<br><br>For example, a report that uses the <a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a> dimension returns <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data adding up to 100 percent for subscribed views <em>and</em> <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data adding up to 100 percent for unsubscribed views. (The total value of all <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> fields in the report is 200 percent.)<br><br>You can use filters to ensure that the report only contains <a href="/youtube/analytics/v1/dimsmets/mets#viewerPercentage">viewerPercentage</a> data for one value (or combination of values) for playback detail dimensions.</div> <h3 id="top-playlists-reports" data-text="Top playlists" tabindex="-1">Top playlists</h3> <p class="note"><strong>Note:</strong> These reports require you to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">200</code> or less. Before January 1, 2013 data is only available for the top 10 playlists. Unlike most other reports, these reports also require you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter.</p> <p>This report lists the content owner's top playlists based on the specified filtering and sorting criteria.</p> <section class="kd-tabbed-horz yt-reporting-api-section" id="content-owner-top-playlists-report"> <article class="yt-reporting-api-report selected"> <header>Recommended</header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration">playlistAverageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistSaves">playlistSaves</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> <article class="yt-reporting-api-report selected"> <header>Using <code translate="no" dir="ltr">isCurated</code></header> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#views">views</a>, <a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageViewDuration">averageViewDuration</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>, <a href="/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist">averageTimeInPlaylist</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#isCurated">isCurated</a>==1</td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a>, <a href="/youtube/analytics/v1/dimsmets/dims#channel">channel</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#province">province</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> <tr> <td>Use 0 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#subscribedStatus">subscribedStatus</a>, <a href="/youtube/analytics/v1/dimsmets/dims#youtubeProduct">youtubeProduct</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-sorting-options"> <td>Sorting options:</td> <td class="notranslate">-<a href="/youtube/analytics/v1/dimsmets/mets#views">views</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#redViews">redViews</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched">estimatedMinutesWatched</a><br>-<a href="/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched">estimatedRedMinutesWatched</a><br/>-<a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a></td> </tr> </table> </article> </section> <h2 id="ad-performance-reports" data-text="Ad performance reports" tabindex="-1">Ad performance reports</h2> <p class="caution"><strong>Note:</strong> Ad performance reports require an authorization token that grants access to the <code translate="no" dir="ltr">https://www.googleapis.com/auth/yt-analytics-monetary.readonly</code> scope.</p> <p>Ad performance reports provide impression-based metrics for ads that ran during video playbacks. These metrics account for each ad impression, and each video playback can yield multiple impressions.</p> <p>The impression-based ad performance metrics are:</p> <p><ul> <li><a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a></li> <li><a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a></li> <li><a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a></li> </ul></p> <p>In addition, some <a href="#video-reports">video reports</a> support the following playback-based ad performance metrics. However, these metrics are not included in ad performance reports.</p> <p><ul> <li><a href="/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm">playbackBasedCpm</a></li> <li><a href="/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks">monetizedPlaybacks</a></li> </ul></p> <h3 class="hide-from-toc" id="ad-performance-by-ad-type" data-text="Ad performance by ad type" tabindex="-1">Ad performance by ad type</h3> <table class="responsive yt-analytics-report-details"> <tr> <th colspan="2">Contents</th> </tr> <tr> <td>Dimensions:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Required</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#adType">adType</a></td> </tr> <tr> <td>Optional</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#day">day</a></td> </tr> </table> </td> </tr> <tr class="yt-analytics-report-metrics"> <td>Metrics:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use 1 or more</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/mets#grossRevenue">grossRevenue</a>, <a href="/youtube/analytics/v1/dimsmets/mets#adImpressions">adImpressions</a>, <a href="/youtube/analytics/v1/dimsmets/mets#cpm">cpm</a></td> </tr> </table> </td> </tr> <tr> <td>Filters:</td> <td class="yt-analytics-120-first-column"> <table> <tr> <td>Use exactly 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#video">video</a>, <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a>, or a supported combination of <a href="/youtube/analytics/v1/dimsmets/dims#uploaderType">uploaderType</a> and <a href="/youtube/analytics/v1/dimsmets/dims#claimedStatus">claimedStatus</a></td> </tr> <tr> <td>Use 0 or 1</td> <td class="notranslate"><a href="/youtube/analytics/v1/dimsmets/dims#country">country</a>, <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a>, <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a></td> </tr> </table> </td> </tr> </table> </div> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-11-15 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-15 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://blog.youtube" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="Blog"> </picture> <span class="devsite-footer-promo-label"> Blog </span> </a> <div class="devsite-footer-promo-description">The latest news on the YouTube blog</div> </li> <li class="devsite-footer-promo"> <a href="https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> </picture> <span class="devsite-footer-promo-label"> GitHub </span> </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> </picture> <span class="devsite-footer-promo-label"> Issue Tracker </span> </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="http://stackoverflow.com/questions/ask?tags=youtube-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> </picture> <span class="devsite-footer-promo-label"> Stack Overflow </span> </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://research.youtube/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="YouTube Researcher Program"> </picture> <span class="devsite-footer-promo-label"> YouTube Researcher Program </span> </a> <div class="devsite-footer-promo-description">For researchers interested in using data from YouTube’s global API</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://developers.google.com/apis-explorer/#p/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google APIs Explorer </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_player_demo" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > YouTube Player Demo </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_subscribe_button" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Configure a Subscribe Button </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/api-services-terms-of-service" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/developer-policies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Developer Policies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/required-minimum-functionality" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Required Minimum Functionality </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/branding-guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Branding Guidelines </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google for Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension11": false, "dimension6": "en", "dimension3": false, "dimension1": "Signed out", "dimension4": "YouTube Analytics and Reporting APIs", "dimension5": "en"}, "gaid": "UA-24532603-1", "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Analytics and Reporting APIs", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="VD9m8fVymwwhqKY0/wn7+yKHUTmI4x"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["MiscFeatureFlags__emergency_css","Profiles__require_profile_eligibility_for_signin","Profiles__enable_profile_collections","Cloud__enable_cloud_shell_fte_user_flow","Cloud__enable_cloud_facet_chat","Cloud__enable_cloudx_experiment_ids","MiscFeatureFlags__enable_explain_this_code","Cloud__enable_legacy_calculator_redirect","Experiments__reqs_query_experiments","TpcFeatures__enable_mirror_tenant_redirects","CloudShell__cloud_code_overflow_menu","Cloud__enable_cloudx_ping","Profiles__enable_awarding_url","Profiles__enable_completecodelab_endpoint","Analytics__enable_clearcut_logging","TpcFeatures__enable_required_headers","Search__enable_dynamic_content_confidential_banner","MiscFeatureFlags__developers_footer_image","MiscFeatureFlags__enable_firebase_utm","Search__enable_page_map","Profiles__enable_recognition_badges","MiscFeatureFlags__enable_variable_operator","Search__enable_ai_search_summaries","Cloud__enable_llm_concierge_chat","MiscFeatureFlags__enable_view_transitions","DevPro__enable_cloud_innovators_plus","Cloud__enable_cloud_dlp_service","Significatio__enable_by_tenant","MiscFeatureFlags__developers_footer_dark_image","BookNav__enable_tenant_cache_key","Profiles__enable_release_notes_notifications","Search__enable_ai_eligibility_checks","Profiles__enable_complete_playlist_endpoint","CloudShell__cloud_shell_button","MiscFeatureFlags__enable_project_variables","Concierge__enable_concierge_restricted","Search__enable_ai_search_summaries_restricted","Cloud__enable_cloud_shell","Profiles__enable_dashboard_curated_recommendations","Profiles__enable_developer_profiles_callout","DevPro__enable_developer_subscriptions","Profiles__enable_page_saving","EngEduTelemetry__enable_engedu_telemetry","Cloud__enable_free_trial_server_call","Profiles__enable_public_developer_profiles","Search__enable_suggestions_from_borg","Concierge__enable_pushui","Concierge__enable_concierge"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[5,4],[15,12],[14,11],[6,5],[13,10],[1,1],[16,13],[12,9],[3,2],[11,8],[4,3]],[[1,1],[2,2]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

YouTube Analytics API: Content Owner Reports | YouTube Analytics and Reporting APIs | Google for Developers