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.
[null,null,["Last updated 2024-12-18 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."]]],[]]
