AdsApp.VideoAge
Stay organized with collections
Save and categorize content based on your preferences.
Represents a Google Ads Age criterion in a Video Campaign.
Methods:
bidding()
Provides access to bidding fields of this video age.
Return values:
exclude()
Excludes this video age from the ad group.
Returns nothing.
getAgeRange()
Returns the age range. Possible return values:
AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44,
AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP,
AGE_RANGE_UNDETERMINED More details can be found on our Age
Ranges page.
Return values:
| Type | Description |
|---|
String |
The age range. |
getEntityType()
Returns the type of this entity as a
String, in this case,
"VideoAge".
Return values:
| Type | Description |
|---|
String |
Type of this entity: "VideoAge". |
getId()
Returns the ID of the video age.
Return values:
| Type | Description |
|---|
String |
The ID of the video age. |
getResourceName()
Returns the resource name of the video age.
Return values:
| Type | Description |
|---|
String |
The resource name of the video age. |
getStatsFor(dateRange)
Returns stats for the specified date range. Supported values:
TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME.
Example:
var stats = age.getStatsFor("THIS_MONTH"); Arguments:
| Name | Type | Description |
|---|
| dateRange |
String |
Date range for which the stats are requested. |
Return values:
| Type | Description |
|---|
AdsApp.Stats |
The stats for the specified date range. |
getStatsFor(dateFrom, dateTo)
Returns stats for the specified custom date range. Both parameters can be
either an object containing year, month, and day fields, or an 8-digit
string in
YYYYMMDD form. For instance,
March 24th,
2013 is represented as either
{year: 2013, month: 3, day:
24} or
"20130324". The date range is inclusive on both
ends, so
forDateRange("20130324", "20130324") defines a range
of a single day.
Arguments:
| Name | Type | Description |
|---|
| dateFrom |
Object |
Start date of the date range. Must be either a string in
YYYYMMDD form, or an object with year,
month and day properties. |
| dateTo |
Object |
End date of the date range. Must be either a string in
YYYYMMDD form, or an object with year,
month and day properties. |
Return values:
| Type | Description |
|---|
AdsApp.Stats |
The stats for the specified date range. |
getVideoAdGroup()
Returns the ad group to which this video age belongs.
Return values:
getVideoCampaign()
Returns the campaign to which this video age belongs.
Return values:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eRepresents a Google Ads Age criterion within Video Campaigns, allowing for targeting or exclusion of specific age demographics.\u003c/p\u003e\n"],["\u003cp\u003eProvides methods to access bidding, retrieve age range, ID, and resource name, and link to the associated ad group and campaign.\u003c/p\u003e\n"],["\u003cp\u003eEnables retrieval of performance statistics for predefined or custom date ranges using the \u003ccode\u003egetStatsFor()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eOffers the ability to exclude specific age ranges from targeting within the ad group using the \u003ccode\u003eexclude()\u003c/code\u003e method.\u003c/p\u003e\n"]]],[],null,["# AdsApp.VideoAge\n\nRepresents a Google Ads Age criterion in a Video Campaign.\n\n### Methods:\n\n| Member | Type | Description |\n|---------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|\n| [bidding()](#bidding) | [AdsApp.VideoCriterionBidding](/google-ads/scripts/docs/reference/adsapp/adsapp_videocriterionbidding) | Provides access to bidding fields of this video age. |\n| [exclude()](#exclude) | `void` | Excludes this video age from the ad group. |\n| [getAgeRange()](#getAgeRange) | `String` | Returns the age range. |\n| [getEntityType()](#getEntityType) | `String` | Returns the type of this entity as a `String`, in this case, `\"VideoAge\"`. |\n| [getId()](#getId) | `String` | Returns the ID of the video age. |\n| [getResourceName()](#getResourceName) | `String` | Returns the resource name of the video age. |\n| [getStatsFor(dateRange)](#getStatsFor_dateRange) | [AdsApp.Stats](/google-ads/scripts/docs/reference/adsapp/adsapp_stats) | Returns stats for the specified date range. |\n| [getStatsFor(dateFrom, dateTo)](#getStatsFor_dateFrom-dateTo) | [AdsApp.Stats](/google-ads/scripts/docs/reference/adsapp/adsapp_stats) | Returns stats for the specified custom date range. |\n| [getVideoAdGroup()](#getVideoAdGroup) | [AdsApp.VideoAdGroup](/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup) | Returns the ad group to which this video age belongs. |\n| [getVideoCampaign()](#getVideoCampaign) | [AdsApp.VideoCampaign](/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign) | Returns the campaign to which this video age belongs. |\n\n`bidding()`\n-----------\n\nProvides access to bidding fields of this video age.\n\n### Return values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------------------------------|---------------------------------------------|\n| [AdsApp.VideoCriterionBidding](/google-ads/scripts/docs/reference/adsapp/adsapp_videocriterionbidding) | Access to bidding fields of this video age. |\n\n`exclude()`\n-----------\n\nExcludes this video age from the ad group.\n\nReturns nothing.\n\n`getAgeRange()`\n---------------\n\nReturns the age range. Possible return values:\n\n`AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44,\nAGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP,\nAGE_RANGE_UNDETERMINED` More details can be found on our [Age\nRanges](/google-ads/api/reference/data/codes-formats#age-ranges) page.\n\n### Return values:\n\n| Type | Description |\n|----------|----------------|\n| `String` | The age range. |\n\n`getEntityType()`\n-----------------\n\nReturns the type of this entity as a `String`, in this case, `\"VideoAge\"`.\n\n### Return values:\n\n| Type | Description |\n|----------|------------------------------------|\n| `String` | Type of this entity: `\"VideoAge\"`. |\n\n`getId()`\n---------\n\nReturns the ID of the video age.\n\n### Return values:\n\n| Type | Description |\n|----------|--------------------------|\n| `String` | The ID of the video age. |\n\n`getResourceName()`\n-------------------\n\nReturns the resource name of the video age.\n\n### Return values:\n\n| Type | Description |\n|----------|-------------------------------------|\n| `String` | The resource name of the video age. |\n\n`getStatsFor(dateRange)`\n------------------------\n\nReturns stats for the specified date range. Supported values:\n\n`TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,\nLAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,\nTHIS_MONTH, LAST_MONTH, ALL_TIME`.\n\nExample:\n\n```gdscript\nvar stats = age.getStatsFor(\"THIS_MONTH\");\n```\n\n### Arguments:\n\n| Name | Type | Description |\n|-----------|----------|-----------------------------------------------|\n| dateRange | `String` | Date range for which the stats are requested. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------|-----------------------------------------|\n| [AdsApp.Stats](/google-ads/scripts/docs/reference/adsapp/adsapp_stats) | The stats for the specified date range. |\n\n`getStatsFor(dateFrom, dateTo)`\n-------------------------------\n\nReturns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` form. For instance, `March 24th,\n2013` is represented as either `{year: 2013, month: 3, day:\n24}` or `\"20130324\"`. The date range is inclusive on both ends, so `forDateRange(\"20130324\", \"20130324\")` defines a range of a single day.\n\n### Arguments:\n\n| Name | Type | Description |\n|----------|----------|-----------------------------------------------------------------------------------------------------------------------------------|\n| dateFrom | `Object` | Start date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |\n| dateTo | `Object` | End date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------|-----------------------------------------|\n| [AdsApp.Stats](/google-ads/scripts/docs/reference/adsapp/adsapp_stats) | The stats for the specified date range. |\n\n`getVideoAdGroup()`\n-------------------\n\nReturns the ad group to which this video age belongs.\n\n### Return values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------------|-----------------------------------------------|\n| [AdsApp.VideoAdGroup](/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup) | The ad group to which this video age belongs. |\n\n`getVideoCampaign()`\n--------------------\n\nReturns the campaign to which this video age belongs.\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------|-----------------------------------------------|\n| [AdsApp.VideoCampaign](/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign) | The campaign to which this video age belongs. |"]]
