--- 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 marketing reports." updated: 2026-09-23T11:03:44Z published: 2026-09-23T11:03:44Z canonical: "docs.supermetrics.com/youtube-fields" --- > ## 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \\| \\| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \| \| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \| \| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement | | 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \\| \\| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \| \| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement \| \| 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. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement | | 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 \\| All-time channel page views (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For views over time, use Views instead \\| \\| 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 \| All-time channel page views (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For views over time, use Views instead \| \| 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 \| All-time channel page views (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For views over time, use Views instead \| \| 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 | All-time channel page views (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For views over time, use Views instead | | 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 \\| All-time subscriber count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For a subscriber trend, use Subscribers gained and Subscribers lost instead. 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 \| All-time subscriber count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For a subscriber trend, use Subscribers gained and Subscribers lost instead. 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 \| All-time subscriber count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For a subscriber trend, use Subscribers gained and Subscribers lost instead. 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 | All-time subscriber count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For a subscriber trend, use Subscribers gained and Subscribers lost instead. 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 \\| All-time public video count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month \\| \\| 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 \| All-time public video count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month \| \| 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 \| All-time public video count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month \| \| 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 | All-time public video count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month | | 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. 09 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.month](/apidocs/field-data-types#time) \\| \| \| Field label \| Month \| \| Description \| Month, e.g. 09 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | month | | \| Field label \| Month \| \| --- \| --- \| \| Description \| Month, e.g. 09 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | Field label | Month | | Description | Month, e.g. 09 | | 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. 09 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.month](/apidocs/field-data-types#time) \\| \| \| Field label \| Month \| \| Description \| Month, e.g. 09 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | month_channel_totals | | \| Field label \| Month \| \| --- \| --- \| \| Description \| Month, e.g. 09 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | Field label | Month | | Description | Month, e.g. 09 | | 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) |