Applies a label to the ad group. name of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.
Note that the ad group cannot have more than 50 labels.
Returns nothing.
Arguments:
Name
Type
Description
name
String
Name of the label to apply.
bidding()
Provides access to this ad group's bidding fields.
The campaign to which this ad group belongs or null if it does not belong to a search or display campaign.
getEntityType()
Returns the type of this entity as a String, in this case, "AdGroup".
Return values:
Type
Description
String
Type of this entity: "AdGroup".
getId()
Returns the ID of the ad group.
Return values:
Type
Description
String
The ID of the ad group.
getMobileBidModifier()
Returns the mobile bid modifier for this ad group.
The bid modifier is a multiplier applied to the ad group's bids on mobile devices. So, for instance, a bid modifier of 1.1 increases the bid to 110% of its original value, and changes a bid of $5.00 to $5.50.
Note that when you set a mobile bid modifier at both campaign- and ad group-level in a single campaign, the ad group mobile bid modifier will be used when determining your bid UNLESS the campaign mobile bid modifier is set to -1 (i.e. -100%) which will opt the entire campaign out of mobile regardless of any ad group mobile bid modifiers that may have been set.
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.
Removes a label from the ad group. name of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.
Returns nothing.
Arguments:
Name
Type
Description
name
String
Name of the label.
removeMobileApp(mobileAppExtension)
Removes a mobile app extension from this ad group.
Sets the mobile bid modifier for this ad group to the specified value.
The bid modifier is a multiplier applied to the ad group's bids on mobile devices. So, for instance, a bid modifier of 1.1 increases the bid to 110% of its original value, and changes a bid of $5.00 to $5.50.
The operation will fail if the ad group's campaign has a mobile bid modifier of -1 (i.e. -100%). Setting a campaign mobile bid modifier to -1 will opt the entire campaign out of mobile.
Note that when you set a mobile bid modifier at both campaign- and ad group-level in a single campaign, the ad group mobile bid modifier will be used when determining your bid UNLESS the campaign mobile bid modifier is set to -1 (i.e. -100%) which will opt the entire campaign out of mobile regardless of any ad group mobile bid modifiers that may be set.
[[["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-04-21 UTC."],[[["The `AdGroup` object in Google Ads Scripts provides access to and management of individual ad groups within your Google Ads campaigns."],["It allows for control over ads, keywords, bidding strategies, targeting, extensions, and more through dedicated methods and properties."],["You can use `AdGroup` methods to automate tasks like creating negative keywords, pausing ad groups, fetching performance data, and applying labels to ad groups."],["It's essential to refer to the full Google Ads Scripts documentation for comprehensive details on all available methods and properties of the `AdGroup` object."]]],[]]
