--- title: "YouTube metrics and dimensions" slug: "youtube-fields" description: "Explore the complete list of YouTube metrics and dimensions available through Supermetrics. Find every data field you need to build your ideal marketing reports." updated: 2026-03-05T14:06:40Z published: 2026-03-05T14:06:40Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # YouTube metrics and dimensions > Supermetrics brings all your YouTube data into [Google Sheets](https://workspace.google.com/marketplace/app/supermetrics/523876908005), [Looker Studio](https://supermetrics.com/products/looker-studio), [Power BI](https://supermetrics.com/products/power-bi), [Excel](https://supermetrics.com/products/excel), [BigQuery](https://supermetrics.com/products/bigquery), [Snowflake](https://supermetrics.com/products/snowflake), [Redshift](https://supermetrics.com/products/amazon-redshift), [Azure](https://supermetrics.com/products/azure-synapse) 44 metrics76 dimensionsSearch fields ### ANNOTATIONS | \| annotationImpressions** \| \| --- \| \| \\| Field label \\| Annotation impressions \\| \\| --- \\| --- \\| \\| Description \\| The total number of annotation impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation impressions \| \| Description \| The total number of annotation impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | annotationImpressions** | | \| Field label \| Annotation impressions \| \| --- \| --- \| \| Description \| The total number of annotation impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Annotation impressions | | Description | The total number of annotation impressions | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| annotationClickableImpressions** \| \| --- \| \| \\| Field label \\| Annotation clickable impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of annotations that appeared and could be clicked \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation clickable impressions \| \| Description \| The number of annotations that appeared and could be clicked \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | annotationClickableImpressions** | | \| Field label \| Annotation clickable impressions \| \| --- \| --- \| \| Description \| The number of annotations that appeared and could be clicked \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Annotation clickable impressions | | Description | The number of annotations that appeared and could be clicked | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| annotationClosableImpressions** \| \| --- \| \| \\| Field label \\| Annotation closable impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of annotations that appeared and could be closed \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation closable impressions \| \| Description \| The number of annotations that appeared and could be closed \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | annotationClosableImpressions** | | \| Field label \| Annotation closable impressions \| \| --- \| --- \| \| Description \| The number of annotations that appeared and could be closed \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Annotation closable impressions | | Description | The number of annotations that appeared and could be closed | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| annotationClicks** \| \| --- \| \| \\| Field label \\| Annotation clicks \\| \\| --- \\| --- \\| \\| Description \\| The number of clicked annotations \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation clicks \| \| Description \| The number of clicked annotations \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | annotationClicks** | | \| Field label \| Annotation clicks \| \| --- \| --- \| \| Description \| The number of clicked annotations \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Annotation clicks | | Description | The number of clicked annotations | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| annotationCloses** \| \| --- \| \| \\| Field label \\| Annotation closes \\| \\| --- \\| --- \\| \\| Description \\| The number of closed annotations \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation closes \| \| Description \| The number of closed annotations \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | annotationCloses** | | \| Field label \| Annotation closes \| \| --- \| --- \| \| Description \| The number of closed annotations \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Annotation closes | | Description | The number of closed annotations | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| annotationClickThroughRate** \| \| --- \| \| \\| Field label \\| Annotation click through rate \\| \\| --- \\| --- \\| \\| Description \\| The ratio of annotations that viewers clicked to the total number of clickable annotation impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation click through rate \| \| Description \| The ratio of annotations that viewers clicked to the total number of clickable annotation impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | annotationClickThroughRate** | | \| Field label \| Annotation click through rate \| \| --- \| --- \| \| Description \| The ratio of annotations that viewers clicked to the total number of clickable annotation impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Annotation click through rate | | Description | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| annotationCloseRate** \| \| --- \| \| \\| Field label \\| Annotation close rate \\| \\| --- \\| --- \\| \\| Description \\| The ratio of annotations that viewers closed to the total number of annotation impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Annotation close rate \| \| Description \| The ratio of annotations that viewers closed to the total number of annotation impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | annotationCloseRate** | | \| Field label \| Annotation close rate \| \| --- \| --- \| \| Description \| The ratio of annotations that viewers closed to the total number of annotation impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Annotation close rate | | Description | The ratio of annotations that viewers closed to the total number of annotation impressions | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | ### AUDIENCE RETENTION | \| elapsedVideoTimeRatio** \| \| --- \| \| \\| Field label \\| Elapsed video time ratio \\| \\| --- \\| --- \\| \\| Description \\| This dimension specifies the ratio of the elapsed portion of the video to the video's length \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Elapsed video time ratio \| \| Description \| This dimension specifies the ratio of the elapsed portion of the video to the video's length \| \| Field type \| dimension \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | --- | | elapsedVideoTimeRatio** | | \| Field label \| Elapsed video time ratio \| \| --- \| --- \| \| Description \| This dimension specifies the ratio of the elapsed portion of the video to the video's length \| \| Field type \| dimension \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Elapsed video time ratio | | Description | This dimension specifies the ratio of the elapsed portion of the video to the video's length | | Field type | dimension | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| audienceWatchRatio** \| \| --- \| \| \\| Field label \\| Audience watch ratio \\| \\| --- \\| --- \\| \\| Description \\| The absolute ratio of viewers watching the video at the given point in the video \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Audience watch ratio \| \| Description \| The absolute ratio of viewers watching the video at the given point in the video \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | audienceWatchRatio** | | \| Field label \| Audience watch ratio \| \| --- \| --- \| \| Description \| The absolute ratio of viewers watching the video at the given point in the video \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Audience watch ratio | | Description | The absolute ratio of viewers watching the video at the given point in the video | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| relativeRetentionPerformance** \| \| --- \| \| \\| Field label \\| Relative retention performance \\| \\| --- \\| --- \\| \\| Description \\| A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Relative retention performance \| \| Description \| A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | relativeRetentionPerformance** | | \| Field label \| Relative retention performance \| \| --- \| --- \| \| Description \| A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Relative retention performance | | Description | A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | ### CARDS | \| cardImpressions** \| \| --- \| \| \\| Field label \\| Card impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Card impressions \| \| Description \| The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | cardImpressions** | | \| Field label \| Card impressions \| \| --- \| --- \| \| Description \| The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Card impressions | | Description | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| cardClicks** \| \| --- \| \| \\| Field label \\| Card clicks \\| \\| --- \\| --- \\| \\| Description \\| The number of times that cards were clicked \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Card clicks \| \| Description \| The number of times that cards were clicked \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | cardClicks** | | \| Field label \| Card clicks \| \| --- \| --- \| \| Description \| The number of times that cards were clicked \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Card clicks | | Description | The number of times that cards were clicked | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| cardClickRate** \| \| --- \| \| \\| Field label \\| Card click rate \\| \\| --- \\| --- \\| \\| Description \\| The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Card click rate \| \| Description \| The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | cardClickRate** | | \| Field label \| Card click rate \| \| --- \| --- \| \| Description \| The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Card click rate | | Description | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| cardTeaserImpressions** \| \| --- \| \| \\| Field label \\| Card teaser impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of times that card teasers were displayed. A video view can generate multiple teaser impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Card teaser impressions \| \| Description \| The number of times that card teasers were displayed. A video view can generate multiple teaser impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | cardTeaserImpressions** | | \| Field label \| Card teaser impressions \| \| --- \| --- \| \| Description \| The number of times that card teasers were displayed. A video view can generate multiple teaser impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Card teaser impressions | | Description | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| cardTeaserClicks** \| \| --- \| \| \\| Field label \\| Card teaser clicks \\| \\| --- \\| --- \\| \\| Description \\| The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Card teaser clicks \| \| Description \| The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | cardTeaserClicks** | | \| Field label \| Card teaser clicks \| \| --- \| --- \| \| Description \| The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Card teaser clicks | | Description | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| cardTeaserClickRate** \| \| --- \| \| \\| Field label \\| Card teaser click rate \\| \\| --- \\| --- \\| \\| Description \\| The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Card teaser click rate \| \| Description \| The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | cardTeaserClickRate** | | \| Field label \| Card teaser click rate \| \| --- \| --- \| \| Description \| The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Card teaser click rate | | Description | The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | ### CHANNEL | \| channel** \| \| --- \| \| \\| Field label \\| Channel ID \\| \\| --- \\| --- \\| \\| Description \\| Id of a channel \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel ID \| \| Description \| Id of a channel \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | channel** | | \| Field label \| Channel ID \| \| --- \| --- \| \| Description \| Id of a channel \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Channel ID | | Description | Id of a channel | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| channel_title** \| \| --- \| \| \\| Field label \\| Channel name \\| \\| --- \\| --- \\| \\| Description \\| Name of the channel \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel name \| \| Description \| Name of the channel \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | channel_title** | | \| Field label \| Channel name \| \| --- \| --- \| \| Description \| Name of the channel \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Channel name | | Description | Name of the channel | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| channel_url** \| \| --- \| \| \\| Field label \\| Channel URL \\| \\| --- \\| --- \\| \\| Description \\| Url of a channel \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel URL \| \| Description \| Url of a channel \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | channel_url** | | \| Field label \| Channel URL \| \| --- \| --- \| \| Description \| Url of a channel \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Channel URL | | Description | Url of a channel | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| channel_description** \| \| --- \| \| \\| Field label \\| Channel description \\| \\| --- \\| --- \\| \\| Description \\| The channel's description \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel description \| \| Description \| The channel's description \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | channel_description** | | \| Field label \| Channel description \| \| --- \| --- \| \| Description \| The channel's description \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Channel description | | Description | The channel's description | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| channel_custom_url** \| \| --- \| \| \\| Field label \\| Channel custom URL \\| \\| --- \\| --- \\| \\| Description \\| The channel's custom URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel custom URL \| \| Description \| The channel's custom URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | channel_custom_url** | | \| Field label \| Channel custom URL \| \| --- \| --- \| \| Description \| The channel's custom URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Channel custom URL | | Description | The channel's custom URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| channel_published_at** \| \| --- \| \| \\| Field label \\| Channel created date \\| \\| --- \\| --- \\| \\| Description \\| The date and time that the channel was created \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Channel created date \| \| Description \| The date and time that the channel was created \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | channel_published_at** | | \| Field label \| Channel created date \| \| --- \| --- \| \| Description \| The date and time that the channel was created \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Channel created date | | Description | The date and time that the channel was created | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| channel_thumbnail_url** \| \| --- \| \| \\| Field label \\| Channel thumbnail URL \\| \\| --- \\| --- \\| \\| Description \\| The URL of channel thumbnail \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Channel thumbnail URL \| \| Description \| The URL of channel thumbnail \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | channel_thumbnail_url** | | \| Field label \| Channel thumbnail URL \| \| --- \| --- \| \| Description \| The URL of channel thumbnail \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Channel thumbnail URL | | Description | The URL of channel thumbnail | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| channel_thumbnail** \| \| --- \| \| \\| Field label \\| Channel thumbnail \\| \\| --- \\| --- \\| \\| Description \\| The default thumbnail for a channel \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \\| Destinations \\| Google Sheets \\| \| \| Field label \| Channel thumbnail \| \| Description \| The default thumbnail for a channel \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| \| Destinations \| Google Sheets \| | | channel_thumbnail** | | \| Field label \| Channel thumbnail \| \| --- \| --- \| \| Description \| The default thumbnail for a channel \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| \| Destinations \| Google Sheets \| | | Field label | Channel thumbnail | | Description | The default thumbnail for a channel | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | Destinations | Google Sheets | | \| channel_country** \| \| --- \| \| \\| Field label \\| Channel country \\| \\| --- \\| --- \\| \\| Description \\| The country with which the channel is associated. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.country](/apidocs/field-data-types#geographical) \\| \| \| Field label \| Channel country \| \| Description \| The country with which the channel is associated. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | channel_country** | | \| Field label \| Channel country \| \| --- \| --- \| \| Description \| The country with which the channel is associated. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | Field label | Channel country | | Description | The country with which the channel is associated. Values are normalized | | Field type | dimension | | Data type | [string.geo.country](/apidocs/field-data-types#geographical) | | \| channel_hidden_subscribers** \| \| --- \| \| \\| Field label \\| Channel hidden subscribers \\| \\| --- \\| --- \\| \\| Description \\| Indicates whether the channel's subscriber count is publicly visible \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Channel hidden subscribers \| \| Description \| Indicates whether the channel's subscriber count is publicly visible \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | channel_hidden_subscribers** | | \| Field label \| Channel hidden subscribers \| \| --- \| --- \| \| Description \| Indicates whether the channel's subscriber count is publicly visible \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Channel hidden subscribers | | Description | Indicates whether the channel's subscriber count is publicly visible | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| channel_views** \| \| --- \| \| \\| Field label \\| Channel total page views \\| \\| --- \\| --- \\| \\| Description \\| The number of times the channel has been viewed (all time) \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Channel total page views \| \| Description \| The number of times the channel has been viewed (all time) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | channel_views** | | \| Field label \| Channel total page views \| \| --- \| --- \| \| Description \| The number of times the channel has been viewed (all time) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Channel total page views | | Description | The number of times the channel has been viewed (all time) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| channel_subscribers** \| \| --- \| \| \\| Field label \\| Channel total subscribers \\| \\| --- \\| --- \\| \\| Description \\| The number of subscribers that the channel has (all time). This value is rounded down to three significant figures \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Channel total subscribers \| \| Description \| The number of subscribers that the channel has (all time). This value is rounded down to three significant figures \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | channel_subscribers** | | \| Field label \| Channel total subscribers \| \| --- \| --- \| \| Description \| The number of subscribers that the channel has (all time). This value is rounded down to three significant figures \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Channel total subscribers | | Description | The number of subscribers that the channel has (all time). This value is rounded down to three significant figures | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| channel_videos** \| \| --- \| \| \\| Field label \\| Channel total video count \\| \\| --- \\| --- \\| \\| Description \\| The number of public videos uploaded to the channel (all time). Note that the value reflects the count of the channel's public videos only \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Channel total video count \| \| Description \| The number of public videos uploaded to the channel (all time). Note that the value reflects the count of the channel's public videos only \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | channel_videos** | | \| Field label \| Channel total video count \| \| --- \| --- \| \| Description \| The number of public videos uploaded to the channel (all time). Note that the value reflects the count of the channel's public videos only \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Channel total video count | | Description | The number of public videos uploaded to the channel (all time). Note that the value reflects the count of the channel's public videos only | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | ### DATASOURCE | \| dataSourceName** \| \| --- \| \| \\| Field label \\| Data source \\| \\| --- \\| --- \\| \\| Description \\| The name of the source for this data, as listed on supermetrics.com/docs \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Data source \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| | | --- | | dataSourceName** | | \| Field label \| Data source \| \| --- \| --- \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| | | Field label | Data source | | Description | The name of the source for this data, as listed on supermetrics.com/docs | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | Destinations | API, Data warehouse | | \| system_metadata.data_source_logins** \| \| --- \| \| \\| Field label \\| Data source logins \\| \\| --- \\| --- \\| \\| Description \\| The data source login accounts that were used to authenticate against the data source \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source logins \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.data_source_logins** | | \| Field label \| Data source logins \| \| --- \| --- \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Data source logins | | Description | The data source login accounts that were used to authenticate against the data source | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.data_source_login_owners** \| \| --- \| \| \\| Field label \\| Data source login owners \\| \\| --- \\| --- \\| \\| Description \\| The Supermetrics users that created the data source login connections \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source login owners \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.data_source_login_owners** | | \| Field label \| Data source login owners \| \| --- \| --- \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Data source login owners | | Description | The Supermetrics users that created the data source login connections | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | ### DEMOGRAPHIC | \| ageGroup** \| \| --- \| \| \\| Field label \\| Age group \\| \\| --- \\| --- \\| \\| Description \\| This dimension identifies the age group of the logged-in users associated with the report data. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.person.age](/apidocs/field-data-types#person) \\| \| \| Field label \| Age group \| \| Description \| This dimension identifies the age group of the logged-in users associated with the report data. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.person.age](/apidocs/field-data-types#person) \| | | --- | | ageGroup** | | \| Field label \| Age group \| \| --- \| --- \| \| Description \| This dimension identifies the age group of the logged-in users associated with the report data. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.person.age](/apidocs/field-data-types#person) \| | | Field label | Age group | | Description | This dimension identifies the age group of the logged-in users associated with the report data. Values are normalized | | Field type | dimension | | Data type | [string.person.age](/apidocs/field-data-types#person) | | \| gender** \| \| --- \| \| \\| Field label \\| Gender \\| \\| --- \\| --- \\| \\| Description \\| This dimension identifies the gender of the logged-in users associated with the report data. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.person.gender](/apidocs/field-data-types#person) \\| \| \| Field label \| Gender \| \| Description \| This dimension identifies the gender of the logged-in users associated with the report data. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.person.gender](/apidocs/field-data-types#person) \| | | gender** | | \| Field label \| Gender \| \| --- \| --- \| \| Description \| This dimension identifies the gender of the logged-in users associated with the report data. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.person.gender](/apidocs/field-data-types#person) \| | | Field label | Gender | | Description | This dimension identifies the gender of the logged-in users associated with the report data. Values are normalized | | Field type | dimension | | Data type | [string.person.gender](/apidocs/field-data-types#person) | ### DEVICE/OS | \| deviceType** \| \| --- \| \| \\| Field label \\| Device type \\| \\| --- \\| --- \\| \\| Description \\| This dimension identifies the physical form factor of the device on which the view occurred. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Device type \| \| Description \| This dimension identifies the physical form factor of the device on which the view occurred. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | deviceType** | | \| Field label \| Device type \| \| --- \| --- \| \| Description \| This dimension identifies the physical form factor of the device on which the view occurred. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Device type | | Description | This dimension identifies the physical form factor of the device on which the view occurred. Values are normalized | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| operatingSystem** \| \| --- \| \| \\| Field label \\| Operating system \\| \\| --- \\| --- \\| \\| Description \\| This dimension identifies the software system of the device on which the view occurred \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Operating system \| \| Description \| This dimension identifies the software system of the device on which the view occurred \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | operatingSystem** | | \| Field label \| Operating system \| \| --- \| --- \| \| Description \| This dimension identifies the software system of the device on which the view occurred \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Operating system | | Description | This dimension identifies the software system of the device on which the view occurred | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| youtubeProduct** \| \| --- \| \| \\| Field label \\| Youtube product \\| \\| --- \\| --- \\| \\| Description \\| This dimension identifies the YouTube service on which the user activity occurred \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Youtube product \| \| Description \| This dimension identifies the YouTube service on which the user activity occurred \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | youtubeProduct** | | \| Field label \| Youtube product \| \| --- \| --- \| \| Description \| This dimension identifies the YouTube service on which the user activity occurred \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Youtube product | | Description | This dimension identifies the YouTube service on which the user activity occurred | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### ENGAGEMENT | \| views** \| \| --- \| \| \\| Field label \\| Video views \\| \\| --- \\| --- \\| \\| Description \\| The number of times that a video was viewed. For Shorts, this counts when the video starts to play or replay \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views \| \| Description \| The number of times that a video was viewed. For Shorts, this counts when the video starts to play or replay \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | views** | | \| Field label \| Video views \| \| --- \| --- \| \| Description \| The number of times that a video was viewed. For Shorts, this counts when the video starts to play or replay \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views | | Description | The number of times that a video was viewed. For Shorts, this counts when the video starts to play or replay | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| engaged_views** \| \| --- \| \| \\| Field label \\| Engaged views \\| \\| --- \\| --- \\| \\| Description \\| The number of times that the video was viewed for at least 4 seconds. This uses the same counting method that Video views used to \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Engaged views \| \| Description \| The number of times that the video was viewed for at least 4 seconds. This uses the same counting method that Video views used to \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | engaged_views** | | \| Field label \| Engaged views \| \| --- \| --- \| \| Description \| The number of times that the video was viewed for at least 4 seconds. This uses the same counting method that Video views used to \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Engaged views | | Description | The number of times that the video was viewed for at least 4 seconds. This uses the same counting method that Video views used to | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| comments** \| \| --- \| \| \\| Field label \\| Comments \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users commented on a video \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Comments \| \| Description \| The number of times that users commented on a video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | comments** | | \| Field label \| Comments \| \| --- \| --- \| \| Description \| The number of times that users commented on a video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Comments | | Description | The number of times that users commented on a video | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| likes** \| \| --- \| \| \\| Field label \\| Likes \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users indicated that they liked a video by giving it a positive rating \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Likes \| \| Description \| The number of times that users indicated that they liked a video by giving it a positive rating \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | likes** | | \| Field label \| Likes \| \| --- \| --- \| \| Description \| The number of times that users indicated that they liked a video by giving it a positive rating \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Likes | | Description | The number of times that users indicated that they liked a video by giving it a positive rating | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| dislikes** \| \| --- \| \| \\| Field label \\| Dislikes \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users indicated that they disliked a video by giving it a negative rating \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Dislikes \| \| Description \| The number of times that users indicated that they disliked a video by giving it a negative rating \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | dislikes** | | \| Field label \| Dislikes \| \| --- \| --- \| \| Description \| The number of times that users indicated that they disliked a video by giving it a negative rating \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Dislikes | | Description | The number of times that users indicated that they disliked a video by giving it a negative rating | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| shares** \| \| --- \| \| \\| Field label \\| Shares \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users shared a video through the Share button \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Shares \| \| Description \| The number of times that users shared a video through the Share button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | shares** | | \| Field label \| Shares \| \| --- \| --- \| \| Description \| The number of times that users shared a video through the Share button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Shares | | Description | The number of times that users shared a video through the Share button | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| subscribersGained** \| \| --- \| \| \\| Field label \\| Gained subscribers \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users subscribed to a channel \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Gained subscribers \| \| Description \| The number of times that users subscribed to a channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | subscribersGained** | | \| Field label \| Gained subscribers \| \| --- \| --- \| \| Description \| The number of times that users subscribed to a channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Gained subscribers | | Description | The number of times that users subscribed to a channel | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| subscribersLost** \| \| --- \| \| \\| Field label \\| Lost subscribers \\| \\| --- \\| --- \\| \\| Description \\| The number of times that users unsubscribed from a channel \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Lost subscribers \| \| Description \| The number of times that users unsubscribed from a channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | subscribersLost** | | \| Field label \| Lost subscribers \| \| --- \| --- \| \| Description \| The number of times that users unsubscribed from a channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Lost subscribers | | Description | The number of times that users unsubscribed from a channel | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| videosAddedToPlaylists** \| \| --- \| \| \\| Field label \\| Videos added to playlist \\| \\| --- \\| --- \\| \\| Description \\| The number of times that videos were added to any YouTube playlists \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Videos added to playlist \| \| Description \| The number of times that videos were added to any YouTube playlists \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | videosAddedToPlaylists** | | \| Field label \| Videos added to playlist \| \| --- \| --- \| \| Description \| The number of times that videos were added to any YouTube playlists \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Videos added to playlist | | Description | The number of times that videos were added to any YouTube playlists | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| videosRemovedFromPlaylists** \| \| --- \| \| \\| Field label \\| Videos removed from playlist \\| \\| --- \\| --- \\| \\| Description \\| The number of times that videos were removed from any YouTube playlists \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Videos removed from playlist \| \| Description \| The number of times that videos were removed from any YouTube playlists \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | videosRemovedFromPlaylists** | | \| Field label \| Videos removed from playlist \| \| --- \| --- \| \| Description \| The number of times that videos were removed from any YouTube playlists \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Videos removed from playlist | | Description | The number of times that videos were removed from any YouTube playlists | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| estimatedMinutesWatched** \| \| --- \| \| \\| Field label \\| Estimated minutes watched \\| \\| --- \\| --- \\| \\| Description \\| The number of minutes that users watched videos for the specified channel, content owner or video \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Estimated minutes watched \| \| Description \| The number of minutes that users watched videos for the specified channel, content owner or video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | estimatedMinutesWatched** | | \| Field label \| Estimated minutes watched \| \| --- \| --- \| \| Description \| The number of minutes that users watched videos for the specified channel, content owner or video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Estimated minutes watched | | Description | The number of minutes that users watched videos for the specified channel, content owner or video | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| averageViewDuration_seconds** \| \| --- \| \| \\| Field label \\| Average view duration (sec) \\| \\| --- \\| --- \\| \\| Description \\| The average length, in seconds, of video playbacks \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Average view duration (sec) \| \| Description \| The average length, in seconds, of video playbacks \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | averageViewDuration_seconds** | | \| Field label \| Average view duration (sec) \| \| --- \| --- \| \| Description \| The average length, in seconds, of video playbacks \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Average view duration (sec) | | Description | The average length, in seconds, of video playbacks | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| avgTimeViewed_minutes** \| \| --- \| \| \\| Field label \\| Average view duration (min) \\| \\| --- \\| --- \\| \\| Description \\| The average length, in minutes, of video playbacks \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Average view duration (min) \| \| Description \| The average length, in minutes, of video playbacks \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | avgTimeViewed_minutes** | | \| Field label \| Average view duration (min) \| \| --- \| --- \| \| Description \| The average length, in minutes, of video playbacks \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | Field label | Average view duration (min) | | Description | The average length, in minutes, of video playbacks | | Field type | metric | | Data type | [float.number.value](/apidocs/field-data-types#number) | | \| avgTimeViewed_hms** \| \| --- \| \| \\| Field label \\| Average view duration (h:m:s) \\| \\| --- \\| --- \\| \\| Description \\| The average length, in h:m:s format, of video playbacks \\| \\| Field type \\| metric \\| \\| Data type \\| [string.time.hms](/apidocs/field-data-types#time) \\| \| \| Field label \| Average view duration (h:m:s) \| \| Description \| The average length, in h:m:s format, of video playbacks \| \| Field type \| metric \| \| Data type \| [string.time.hms](/apidocs/field-data-types#time) \| | | avgTimeViewed_hms** | | \| Field label \| Average view duration (h:m:s) \| \| --- \| --- \| \| Description \| The average length, in h:m:s format, of video playbacks \| \| Field type \| metric \| \| Data type \| [string.time.hms](/apidocs/field-data-types#time) \| | | Field label | Average view duration (h:m:s) | | Description | The average length, in h:m:s format, of video playbacks | | Field type | metric | | Data type | [string.time.hms](/apidocs/field-data-types#time) | | \| averageViewPercentage** \| \| --- \| \| \\| Field label \\| Average view duration percentage \\| \\| --- \\| --- \\| \\| Description \\| The average percentage of a video watched during a video playback \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Average view duration percentage \| \| Description \| The average percentage of a video watched during a video playback \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | averageViewPercentage** | | \| Field label \| Average view duration percentage \| \| --- \| --- \| \| Description \| The average percentage of a video watched during a video playback \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Average view duration percentage | | Description | The average percentage of a video watched during a video playback | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| viewerPercentage** \| \| --- \| \| \\| Field label \\| Viewer percentage \\| \\| --- \\| --- \\| \\| Description \\| The percentage of viewers who were logged in when watching the video \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.percentage](/apidocs/field-data-types#number) \\| \| \| Field label \| Viewer percentage \| \| Description \| The percentage of viewers who were logged in when watching the video \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| | | viewerPercentage** | | \| Field label \| Viewer percentage \| \| --- \| --- \| \| Description \| The percentage of viewers who were logged in when watching the video \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| | | Field label | Viewer percentage | | Description | The percentage of viewers who were logged in when watching the video | | Field type | metric | | Data type | [float.number.percentage](/apidocs/field-data-types#number) | ### GEOGRAPHIES | \| country** \| \| --- \| \| \\| Field label \\| Country \\| \\| --- \\| --- \\| \\| Description \\| The country associated with the metrics in the report row. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.country](/apidocs/field-data-types#geographical) \\| \| \| Field label \| Country \| \| Description \| The country associated with the metrics in the report row. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | --- | | country** | | \| Field label \| Country \| \| --- \| --- \| \| Description \| The country associated with the metrics in the report row. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | Field label | Country | | Description | The country associated with the metrics in the report row. Values are normalized | | Field type | dimension | | Data type | [string.geo.country](/apidocs/field-data-types#geographical) | | \| province** \| \| --- \| \| \\| Field label \\| US State \\| \\| --- \\| --- \\| \\| Description \\| The U.S. state or territory associated with the metrics in the report row. Using this field will restrict country to US. Values are normalized \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.region](/apidocs/field-data-types#geographical) \\| \| \| Field label \| US State \| \| Description \| The U.S. state or territory associated with the metrics in the report row. Using this field will restrict country to US. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.region](/apidocs/field-data-types#geographical) \| | | province** | | \| Field label \| US State \| \| --- \| --- \| \| Description \| The U.S. state or territory associated with the metrics in the report row. Using this field will restrict country to US. Values are normalized \| \| Field type \| dimension \| \| Data type \| [string.geo.region](/apidocs/field-data-types#geographical) \| | | Field label | US State | | Description | The U.S. state or territory associated with the metrics in the report row. Using this field will restrict country to US. Values are normalized | | Field type | dimension | | Data type | [string.geo.region](/apidocs/field-data-types#geographical) | ### MONETIZATION | \| adType** \| \| --- \| \| \\| Field label \\| Ad type \\| \\| --- \\| --- \\| \\| Description \\| The dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad type \| \| Description \| The dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | adType** | | \| Field label \| Ad type \| \| --- \| --- \| \| Description \| The dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Ad type | | Description | The dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| redViews** \| \| --- \| \| \\| Field label \\| YouTube Premium views \\| \\| --- \\| --- \\| \\| Description \\| The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| YouTube Premium views \| \| Description \| The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | redViews** | | \| Field label \| YouTube Premium views \| \| --- \| --- \| \| Description \| The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | YouTube Premium views | | Description | The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| estimatedRedMinutesWatched** \| \| --- \| \| \\| Field label \\| Estimated YouTube Premium minutes watched \\| \\| --- \\| --- \\| \\| Description \\| The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Estimated YouTube Premium minutes watched \| \| Description \| The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | estimatedRedMinutesWatched** | | \| Field label \| Estimated YouTube Premium minutes watched \| \| --- \| --- \| \| Description \| The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Estimated YouTube Premium minutes watched | | Description | The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| estimatedRevenue** \| \| --- \| \| \\| Field label \\| Estimated revenue \\| \\| --- \\| --- \\| \\| Description \\| The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. Requires monetization be enabled for the channel \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Estimated revenue \| \| Description \| The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | estimatedRevenue** | | \| Field label \| Estimated revenue \| \| --- \| --- \| \| Description \| The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | Field label | Estimated revenue | | Description | The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. Requires monetization be enabled for the channel | | Field type | metric | | Data type | [float.number.value](/apidocs/field-data-types#number) | | \| monetizedPlaybacks** \| \| --- \| \| \\| Field label \\| Monetized Playbacks \\| \\| --- \\| --- \\| \\| Description \\| The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%. Requires monetization be enabled for the channel \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Monetized Playbacks \| \| Description \| The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | monetizedPlaybacks** | | \| Field label \| Monetized Playbacks \| \| --- \| --- \| \| Description \| The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Monetized Playbacks | | Description | The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%. Requires monetization be enabled for the channel | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| playbackBasedCpm** \| \| --- \| \| \\| Field label \\| Playback Based CPM \\| \\| --- \\| --- \\| \\| Description \\| The estimated gross revenue per thousand playbacks. Requires monetization be enabled for the channel \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Playback Based CPM \| \| Description \| The estimated gross revenue per thousand playbacks. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | playbackBasedCpm** | | \| Field label \| Playback Based CPM \| \| --- \| --- \| \| Description \| The estimated gross revenue per thousand playbacks. Requires monetization be enabled for the channel \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | Field label | Playback Based CPM | | Description | The estimated gross revenue per thousand playbacks. Requires monetization be enabled for the channel | | Field type | metric | | Data type | [float.number.value](/apidocs/field-data-types#number) | | \| grossRevenue** \| \| --- \| \| \\| Field label \\| Gross revenue (USD) \\| \\| --- \\| --- \\| \\| Description \\| The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Gross revenue (USD) \| \| Description \| The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | grossRevenue** | | \| Field label \| Gross revenue (USD) \| \| --- \| --- \| \| Description \| The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| | | Field label | Gross revenue (USD) | | Description | The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range | | Field type | metric | | Data type | [float.number.value](/apidocs/field-data-types#number) | | \| grossRevenue_gbp** \| \| --- \| \| \\| Field label \\| Gross revenue (GBP) \\| \\| --- \\| --- \\| \\| Description \\| The estimated gross revenue, in GBP, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| Services \\| [Currency conversion](/apidocs/field-data-services#currency-conversion) \\| \| \| Field label \| Gross revenue (GBP) \| \| Description \| The estimated gross revenue, in GBP, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | grossRevenue_gbp** | | \| Field label \| Gross revenue (GBP) \| \| --- \| --- \| \| Description \| The estimated gross revenue, in GBP, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | Field label | Gross revenue (GBP) | | Description | The estimated gross revenue, in GBP, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | Services | [Currency conversion](/apidocs/field-data-services#currency-conversion) | | \| grossRevenue_eur** \| \| --- \| \| \\| Field label \\| Gross revenue (EUR) \\| \\| --- \\| --- \\| \\| Description \\| The estimated gross revenue, in EUR, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| Services \\| [Currency conversion](/apidocs/field-data-services#currency-conversion) \\| \| \| Field label \| Gross revenue (EUR) \| \| Description \| The estimated gross revenue, in EUR, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | grossRevenue_eur** | | \| Field label \| Gross revenue (EUR) \| \| --- \| --- \| \| Description \| The estimated gross revenue, in EUR, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | Field label | Gross revenue (EUR) | | Description | The estimated gross revenue, in EUR, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | Services | [Currency conversion](/apidocs/field-data-services#currency-conversion) | | \| adImpressions** \| \| --- \| \| \\| Field label \\| Ad impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of verified ad impressions served \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Ad impressions \| \| Description \| The number of verified ad impressions served \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | adImpressions** | | \| Field label \| Ad impressions \| \| --- \| --- \| \| Description \| The number of verified ad impressions served \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Ad impressions | | Description | The number of verified ad impressions served | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| cpm** \| \| --- \| \| \\| Field label \\| CPM \\| \\| --- \\| --- \\| \\| Description \\| The estimated gross revenue per thousand ad impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| CPM \| \| Description \| The estimated gross revenue per thousand ad impressions \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | cpm** | | \| Field label \| CPM \| \| --- \| --- \| \| Description \| The estimated gross revenue per thousand ad impressions \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | CPM | | Description | The estimated gross revenue per thousand ad impressions | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | ### QUERY | \| system_metadata.query_date_range_start** \| \| --- \| \| \\| Field label \\| Start date \\| \\| --- \\| --- \\| \\| Description \\| The start date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Start date \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | --- | | system_metadata.query_date_range_start** | | \| Field label \| Start date \| \| --- \| --- \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Start date | | Description | The start date of the requested query | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| system_metadata.query_date_range_end** \| \| --- \| \| \\| Field label \\| End date \\| \\| --- \\| --- \\| \\| Description \\| The end date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| End date \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | system_metadata.query_date_range_end** | | \| Field label \| End date \| \| --- \| --- \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | End date | | Description | The end date of the requested query | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| system_metadata.query_timezone** \| \| --- \| \| \\| Field label \\| Timezone \\| \\| --- \\| --- \\| \\| Description \\| The timezone that is supplied to the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.timezone](/apidocs/field-data-types#time) \\| \| \| Field label \| Timezone \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| | | system_metadata.query_timezone** | | \| Field label \| Timezone \| \| --- \| --- \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| | | Field label | Timezone | | Description | The timezone that is supplied to the query | | Field type | dimension | | Data type | [string.time.timezone](/apidocs/field-data-types#time) | | \| system_metadata.query_filters** \| \| --- \| \| \\| Field label \\| Filters \\| \\| --- \\| --- \\| \\| Description \\| All filters used in the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Filters \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_filters** | | \| Field label \| Filters \| \| --- \| --- \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Filters | | Description | All filters used in the query | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.query_date_start** \| \| --- \| \| \\| Field label \\| Start \\| \\| --- \\| --- \\| \\| Description \\| When the query was started \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| Start \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | system_metadata.query_date_start** | | \| Field label \| Start \| \| --- \| --- \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | Field label | Start | | Description | When the query was started | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | \| system_metadata.query_date_end** \| \| --- \| \| \\| Field label \\| End \\| \\| --- \\| --- \\| \\| Description \\| When the query completed \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| End \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | system_metadata.query_date_end** | | \| Field label \| End \| \| --- \| --- \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | Field label | End | | Description | When the query completed | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | \| system_metadata.query_duration** \| \| --- \| \| \\| Field label \\| Duration \\| \\| --- \\| --- \\| \\| Description \\| The duration in seconds of the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.duration.seconds](/apidocs/field-data-types#duration) \\| \| \| Field label \| Duration \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| | | system_metadata.query_duration** | | \| Field label \| Duration \| \| --- \| --- \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| | | Field label | Duration | | Description | The duration in seconds of the query | | Field type | dimension | | Data type | [int.duration.seconds](/apidocs/field-data-types#duration) | | \| system_metadata.query_accounts** \| \| --- \| \| \\| Field label \\| Accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of accounts of which the data was pulled from \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Accounts \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_accounts** | | \| Field label \| Accounts \| \| --- \| --- \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Accounts | | Description | A list of accounts of which the data was pulled from | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.query_excluded_accounts** \| \| --- \| \| \\| Field label \\| Excluded invalid accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Excluded invalid accounts \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_excluded_accounts** | | \| Field label \| Excluded invalid accounts \| \| --- \| --- \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Excluded invalid accounts | | Description | A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | ### TIME | \| today** \| \| --- \| \| \\| Field label \\| Today \\| \\| --- \\| --- \\| \\| Description \\| Today's date, e.g. 2017-01-31 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Today \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | --- | | today** | | \| Field label \| Today \| \| --- \| --- \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | Field label | Today | | Description | Today's date, e.g. 2017-01-31 | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | Destinations | API, Data warehouse | | \| year** \| \| --- \| \| \\| Field label \\| Year \\| \\| --- \\| --- \\| \\| Description \\| Year, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | year** | | \| Field label \| Year \| \| --- \| --- \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year | | Description | Year, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearOfWeek** \| \| --- \| \| \\| Field label \\| Year of week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Sun-Sat) \| \| Description \| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearOfWeek** | | \| Field label \| Year of week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Sun-Sat) | | Description | Year of week for US-style Sunday-Saturday weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearOfWeekIso** \| \| --- \| \| \\| Field label \\| Year of week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Mon-Sun) \| \| Description \| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearOfWeekIso** | | \| Field label \| Year of week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Mon-Sun) | | Description | Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearMonth** \| \| --- \| \| \\| Field label \\| Year & month \\| \\| --- \\| --- \\| \\| Description \\| Year and month, e.g. 2017\\\|06 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearmonth](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & month \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | yearMonth** | | \| Field label \| Year & month \| \| --- \| --- \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | Field label | Year & month | | Description | Year and month, e.g. 2017\|06 | | Field type | dimension | | Data type | [string.time.yearmonth](/apidocs/field-data-types#time) | | \| month** \| \| --- \| \| \\| Field label \\| Month \\| \\| --- \\| --- \\| \\| Description \\| Month, e.g. 6 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.month](/apidocs/field-data-types#time) \\| \| \| Field label \| Month \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | month** | | \| Field label \| Month \| \| --- \| --- \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | Field label | Month | | Description | Month, e.g. 6 | | Field type | dimension | | Data type | [string.time.month](/apidocs/field-data-types#time) | | \| yearWeek** \| \| --- \| \| \\| Field label \\| Year & week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweek](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Sun-Sat) \| \| Description \| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | yearWeek** | | \| Field label \| Year & week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | Field label | Year & week (Sun-Sat) | | Description | Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweek](/apidocs/field-data-types#time) | | \| yearWeekIso** \| \| --- \| \| \\| Field label \\| Year & week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Mon-Sun) \| \| Description \| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | yearWeekIso** | | \| Field label \| Year & week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | Field label | Year & week (Mon-Sun) | | Description | Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweekiso](/apidocs/field-data-types#time) | | \| week** \| \| --- \| \| \\| Field label \\| Week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| US week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.week](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Sun-Sat) \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | week** | | \| Field label \| Week (Sun-Sat) \| \| --- \| --- \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | Field label | Week (Sun-Sat) | | Description | US week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.week](/apidocs/field-data-types#time) | | \| weekIso** \| \| --- \| \| \\| Field label \\| Week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| ISO week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.weekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Mon-Sun) \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | weekIso** | | \| Field label \| Week (Mon-Sun) \| \| --- \| --- \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | Field label | Week (Mon-Sun) | | Description | ISO week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.weekiso](/apidocs/field-data-types#time) | | \| dayOfMonth** \| \| --- \| \| \\| Field label \\| Day of month \\| \\| --- \\| --- \\| \\| Description \\| Day of month, e.g. 2 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofmonth](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of month \| \| Description \| Day of month, e.g. 2 \| \| Field type \| dimension \| \| Data type \| [string.time.dayofmonth](/apidocs/field-data-types#time) \| | | dayOfMonth** | | \| Field label \| Day of month \| \| --- \| --- \| \| Description \| Day of month, e.g. 2 \| \| Field type \| dimension \| \| Data type \| [string.time.dayofmonth](/apidocs/field-data-types#time) \| | | Field label | Day of month | | Description | Day of month, e.g. 2 | | Field type | dimension | | Data type | [string.time.dayofmonth](/apidocs/field-data-types#time) | | \| dayOfWeekName** \| \| --- \| \| \\| Field label \\| Day of week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofweek](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of week (Sun-Sat) \| \| Description \| Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweek](/apidocs/field-data-types#time) \| | | dayOfWeekName** | | \| Field label \| Day of week (Sun-Sat) \| \| --- \| --- \| \| Description \| Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweek](/apidocs/field-data-types#time) \| | | Field label | Day of week (Sun-Sat) | | Description | Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday | | Field type | dimension | | Data type | [string.time.dayofweek](/apidocs/field-data-types#time) | | \| dayOfWeekNameIso** \| \| --- \| \| \\| Field label \\| Day of week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofweekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of week (Mon-Sun) \| \| Description \| Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweekiso](/apidocs/field-data-types#time) \| | | dayOfWeekNameIso** | | \| Field label \| Day of week (Mon-Sun) \| \| --- \| --- \| \| Description \| Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweekiso](/apidocs/field-data-types#time) \| | | Field label | Day of week (Mon-Sun) | | Description | Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday | | Field type | dimension | | Data type | [string.time.dayofweekiso](/apidocs/field-data-types#time) | | \| date** \| \| --- \| \| \\| Field label \\| Date \\| \\| --- \\| --- \\| \\| Description \\| Date, e.g. 2017-01-31 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Date \| \| Description \| Date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | date** | | \| Field label \| Date \| \| --- \| --- \| \| Description \| Date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Date | | Description | Date, e.g. 2017-01-31 | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| query_date_range_start** \| \| --- \| \| \\| Field label \\| Query date range start \\| \\| --- \\| --- \\| \\| Description \\| First date of the requested query date range \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Query date range start \| \| Description \| First date of the requested query date range \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | query_date_range_start** | | \| Field label \| Query date range start \| \| --- \| --- \| \| Description \| First date of the requested query date range \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | Field label | Query date range start | | Description | First date of the requested query date range | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | Destinations | API, Data warehouse | | \| year_channel_totals** \| \| --- \| \| \\| Field label \\| Year \\| \\| --- \\| --- \\| \\| Description \\| Year, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | year_channel_totals** | | \| Field label \| Year \| \| --- \| --- \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year | | Description | Year, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearOfWeek_channel_totals** \| \| --- \| \| \\| Field label \\| Year of week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Sun-Sat) \| \| Description \| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearOfWeek_channel_totals** | | \| Field label \| Year of week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year of week for US-style Sunday-Saturday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Sun-Sat) | | Description | Year of week for US-style Sunday-Saturday weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearOfWeekIso_channel_totals** \| \| --- \| \| \\| Field label \\| Year of week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Mon-Sun) \| \| Description \| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearOfWeekIso_channel_totals** | | \| Field label \| Year of week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Mon-Sun) | | Description | Year of week for ISO standard Monday-Sunday weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearMonth_channel_totals** \| \| --- \| \| \\| Field label \\| Year & month \\| \\| --- \\| --- \\| \\| Description \\| Year and month, e.g. 2017\\\|06 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearmonth](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & month \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | yearMonth_channel_totals** | | \| Field label \| Year & month \| \| --- \| --- \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | Field label | Year & month | | Description | Year and month, e.g. 2017\|06 | | Field type | dimension | | Data type | [string.time.yearmonth](/apidocs/field-data-types#time) | | \| month_channel_totals** \| \| --- \| \| \\| Field label \\| Month \\| \\| --- \\| --- \\| \\| Description \\| Month, e.g. 6 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.month](/apidocs/field-data-types#time) \\| \| \| Field label \| Month \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | month_channel_totals** | | \| Field label \| Month \| \| --- \| --- \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | Field label | Month | | Description | Month, e.g. 6 | | Field type | dimension | | Data type | [string.time.month](/apidocs/field-data-types#time) | | \| yearWeek_channel_totals** \| \| --- \| \| \\| Field label \\| Year & week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweek](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Sun-Sat) \| \| Description \| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | yearWeek_channel_totals** | | \| Field label \| Year & week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year and week for US-style Sunday-Saturday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | Field label | Year & week (Sun-Sat) | | Description | Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweek](/apidocs/field-data-types#time) | | \| yearWeekIso_channel_totals** \| \| --- \| \| \\| Field label \\| Year & week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Mon-Sun) \| \| Description \| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | yearWeekIso_channel_totals** | | \| Field label \| Year & week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | Field label | Year & week (Mon-Sun) | | Description | Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweekiso](/apidocs/field-data-types#time) | | \| week_channel_totals** \| \| --- \| \| \\| Field label \\| Week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| US week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.week](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Sun-Sat) \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | week_channel_totals** | | \| Field label \| Week (Sun-Sat) \| \| --- \| --- \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | Field label | Week (Sun-Sat) | | Description | US week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.week](/apidocs/field-data-types#time) | | \| weekIso_channel_totals** \| \| --- \| \| \\| Field label \\| Week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| ISO week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.weekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Mon-Sun) \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | weekIso_channel_totals** | | \| Field label \| Week (Mon-Sun) \| \| --- \| --- \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | Field label | Week (Mon-Sun) | | Description | ISO week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.weekiso](/apidocs/field-data-types#time) | ### TRAFFIC SOURCE | \| insightTrafficSourceType** \| \| --- \| \| \\| Field label \\| Traffic source type \\| \\| --- \\| --- \\| \\| Description \\| This dimension describes the manner in which users reached the video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Traffic source type \| \| Description \| This dimension describes the manner in which users reached the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | insightTrafficSourceType** | | \| Field label \| Traffic source type \| \| --- \| --- \| \| Description \| This dimension describes the manner in which users reached the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Traffic source type | | Description | This dimension describes the manner in which users reached the video | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### VIDEO | \| video** \| \| --- \| \| \\| Field label \\| Video ID \\| \\| --- \\| --- \\| \\| Description \\| Id of a channel`s video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Video ID \| \| Description \| Id of a channel`s video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | video** | | \| Field label \| Video ID \| \| --- \| --- \| \| Description \| Id of a channel`s video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Video ID | | Description | Id of a channel`s video | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| video_privacy_status** \| \| --- \| \| \\| Field label \\| Video visibility status \\| \\| --- \\| --- \\| \\| Description \\| The video's visibility status. Values may be private, public, unlisted \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Video visibility status \| \| Description \| The video's visibility status. Values may be private, public, unlisted \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | video_privacy_status** | | \| Field label \| Video visibility status \| \| --- \| --- \| \| Description \| The video's visibility status. Values may be private, public, unlisted \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Video visibility status | | Description | The video's visibility status. Values may be private, public, unlisted | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| video_title** \| \| --- \| \| \\| Field label \\| Video title \\| \\| --- \\| --- \\| \\| Description \\| Title of the video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Video title \| \| Description \| Title of the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | video_title** | | \| Field label \| Video title \| \| --- \| --- \| \| Description \| Title of the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Video title | | Description | Title of the video | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| video_url** \| \| --- \| \| \\| Field label \\| Video URL \\| \\| --- \\| --- \\| \\| Description \\| Url of a video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Video URL \| \| Description \| Url of a video \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | video_url** | | \| Field label \| Video URL \| \| --- \| --- \| \| Description \| Url of a video \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Video URL | | Description | Url of a video | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| video_thumbnail_url** \| \| --- \| \| \\| Field label \\| Video thumbnail URL \\| \\| --- \\| --- \\| \\| Description \\| Thumbnail of the video URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Video thumbnail URL \| \| Description \| Thumbnail of the video URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | video_thumbnail_url** | | \| Field label \| Video thumbnail URL \| \| --- \| --- \| \| Description \| Thumbnail of the video URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Video thumbnail URL | | Description | Thumbnail of the video URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| video_thumbnail** \| \| --- \| \| \\| Field label \\| Video thumbnail \\| \\| --- \\| --- \\| \\| Description \\| The thumbnail for a video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \\| Destinations \\| Google Sheets \\| \| \| Field label \| Video thumbnail \| \| Description \| The thumbnail for a video \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| \| Destinations \| Google Sheets \| | | video_thumbnail** | | \| Field label \| Video thumbnail \| \| --- \| --- \| \| Description \| The thumbnail for a video \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| \| Destinations \| Google Sheets \| | | Field label | Video thumbnail | | Description | The thumbnail for a video | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | Destinations | Google Sheets | | \| video_upload_status** \| \| --- \| \| \\| Field label \\| Video upload status \\| \\| --- \\| --- \\| \\| Description \\| The status of the uploaded video. Values may be: deleted, failed, processed, rejected, uploaded \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Video upload status \| \| Description \| The status of the uploaded video. Values may be: deleted, failed, processed, rejected, uploaded \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | video_upload_status** | | \| Field label \| Video upload status \| \| --- \| --- \| \| Description \| The status of the uploaded video. Values may be: deleted, failed, processed, rejected, uploaded \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Video upload status | | Description | The status of the uploaded video. Values may be: deleted, failed, processed, rejected, uploaded | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| video_failure_reason** \| \| --- \| \| \\| Field label \\| Video failure reason \\| \\| --- \\| --- \\| \\| Description \\| This value explains why a video failed to upload. This property is only present if the Video upload status property indicates that the upload failed \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Video failure reason \| \| Description \| This value explains why a video failed to upload. This property is only present if the Video upload status property indicates that the upload failed \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | video_failure_reason** | | \| Field label \| Video failure reason \| \| --- \| --- \| \| Description \| This value explains why a video failed to upload. This property is only present if the Video upload status property indicates that the upload failed \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Video failure reason | | Description | This value explains why a video failed to upload. This property is only present if the Video upload status property indicates that the upload failed | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| video_rejection_reason** \| \| --- \| \| \\| Field label \\| Video rejection reason \\| \\| --- \\| --- \\| \\| Description \\| This value explains why YouTube rejected an uploaded video. This property is only present if the Video upload status property indicates that the upload was rejected \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Video rejection reason \| \| Description \| This value explains why YouTube rejected an uploaded video. This property is only present if the Video upload status property indicates that the upload was rejected \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | video_rejection_reason** | | \| Field label \| Video rejection reason \| \| --- \| --- \| \| Description \| This value explains why YouTube rejected an uploaded video. This property is only present if the Video upload status property indicates that the upload was rejected \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Video rejection reason | | Description | This value explains why YouTube rejected an uploaded video. This property is only present if the Video upload status property indicates that the upload was rejected | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| video_length** \| \| --- \| \| \\| Field label \\| Video length \\| \\| --- \\| --- \\| \\| Description \\| The length of the video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.hms](/apidocs/field-data-types#time) \\| \| \| Field label \| Video length \| \| Description \| The length of the video \| \| Field type \| dimension \| \| Data type \| [string.time.hms](/apidocs/field-data-types#time) \| | | video_length** | | \| Field label \| Video length \| \| --- \| --- \| \| Description \| The length of the video \| \| Field type \| dimension \| \| Data type \| [string.time.hms](/apidocs/field-data-types#time) \| | | Field label | Video length | | Description | The length of the video | | Field type | dimension | | Data type | [string.time.hms](/apidocs/field-data-types#time) | | \| video_embeddable** \| \| --- \| \| \\| Field label \\| Video embeddability \\| \\| --- \\| --- \\| \\| Description \\| This value indicates whether the video can be embedded on another website \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Video embeddability \| \| Description \| This value indicates whether the video can be embedded on another website \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | video_embeddable** | | \| Field label \| Video embeddability \| \| --- \| --- \| \| Description \| This value indicates whether the video can be embedded on another website \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Video embeddability | | Description | This value indicates whether the video can be embedded on another website | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| video_public_stats_viewable** \| \| --- \| \| \\| Field label \\| Video public stats viewable \\| \\| --- \\| --- \\| \\| Description \\| This value indicates whether the extended video statistics on the video's watch page are publicly viewable \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Video public stats viewable \| \| Description \| This value indicates whether the extended video statistics on the video's watch page are publicly viewable \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | video_public_stats_viewable** | | \| Field label \| Video public stats viewable \| \| --- \| --- \| \| Description \| This value indicates whether the extended video statistics on the video's watch page are publicly viewable \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Video public stats viewable | | Description | This value indicates whether the extended video statistics on the video's watch page are publicly viewable | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| video_made_for_kids** \| \| --- \| \| \\| Field label \\| Video made for kids \\| \\| --- \\| --- \\| \\| Description \\| This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Video made for kids \| \| Description \| This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | video_made_for_kids** | | \| Field label \| Video made for kids \| \| --- \| --- \| \| Description \| This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Video made for kids | | Description | This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| creatorContentType** \| \| --- \| \| \\| Field label \\| Creator content type \\| \\| --- \\| --- \\| \\| Description \\| Identifies the type of YouTube content. Supported values are liveStream, shorts, story, and videoOnDemand \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Creator content type \| \| Description \| Identifies the type of YouTube content. Supported values are liveStream, shorts, story, and videoOnDemand \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | creatorContentType** | | \| Field label \| Creator content type \| \| --- \| --- \| \| Description \| Identifies the type of YouTube content. Supported values are liveStream, shorts, story, and videoOnDemand \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Creator content type | | Description | Identifies the type of YouTube content. Supported values are liveStream, shorts, story, and videoOnDemand | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| video_published_at** \| \| --- \| \| \\| Field label \\| Published time \\| \\| --- \\| --- \\| \\| Description \\| The published date and time of the video that the search result identifies \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \\| Destinations \\| \\| \| \| Field label \| Published time \| \| Description \| The published date and time of the video that the search result identifies \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| \| Destinations \| \| | | video_published_at** | | \| Field label \| Published time \| \| --- \| --- \| \| Description \| The published date and time of the video that the search result identifies \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| \| Destinations \| \| | | Field label | Published time | | Description | The published date and time of the video that the search result identifies | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | Destinations | | | \| video_published_date** \| \| --- \| \| \\| Field label \\| Published date \\| \\| --- \\| --- \\| \\| Description \\| The published date of the video that the search result identifies \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Published date \| \| Description \| The published date of the video that the search result identifies \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | video_published_date** | | \| Field label \| Published date \| \| --- \| --- \| \| Description \| The published date of the video that the search result identifies \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Published date | | Description | The published date of the video that the search result identifies | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| video_description** \| \| --- \| \| \\| Field label \\| Video description \\| \\| --- \\| --- \\| \\| Description \\| Description of a video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Video description \| \| Description \| Description of a video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | video_description** | | \| Field label \| Video description \| \| --- \| --- \| \| Description \| Description of a video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Video description | | Description | Description of a video | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| video_tags** \| \| --- \| \| \\| Field label \\| Video tags \\| \\| --- \\| --- \\| \\| Description \\| A list of keyword tags associated with the video \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Video tags \| \| Description \| A list of keyword tags associated with the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | video_tags** | | \| Field label \| Video tags \| \| --- \| --- \| \| Description \| A list of keyword tags associated with the video \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Video tags | | Description | A list of keyword tags associated with the video | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| liveBroadcastContent** \| \| --- \| \| \\| Field label \\| Live broadcast content \\| \\| --- \\| --- \\| \\| Description \\| An indication of whether a video resource has live broadcast content. Valid property values are upcoming, live, and none \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Live broadcast content \| \| Description \| An indication of whether a video resource has live broadcast content. Valid property values are upcoming, live, and none \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | liveBroadcastContent** | | \| Field label \| Live broadcast content \| \| --- \| --- \| \| Description \| An indication of whether a video resource has live broadcast content. Valid property values are upcoming, live, and none \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Live broadcast content | | Description | An indication of whether a video resource has live broadcast content. Valid property values are upcoming, live, and none | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| liveOrOnDemand** \| \| --- \| \| \\| Field label \\| Live or on-demand \\| \\| --- \\| --- \\| \\| Description \\| Indicates whether the user activity metrics in the data row are associated with views of a live broadcast or was replayed on-demand. Possible values are LIVE and ON_DEMAND \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Live or on-demand \| \| Description \| Indicates whether the user activity metrics in the data row are associated with views of a live broadcast or was replayed on-demand. Possible values are LIVE and ON_DEMAND \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | liveOrOnDemand** | | \| Field label \| Live or on-demand \| \| --- \| --- \| \| Description \| Indicates whether the user activity metrics in the data row are associated with views of a live broadcast or was replayed on-demand. Possible values are LIVE and ON_DEMAND \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Live or on-demand | | Description | Indicates whether the user activity metrics in the data row are associated with views of a live broadcast or was replayed on-demand. Possible values are LIVE and ON_DEMAND | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) |