This is the legacy documentation for Google Ads scripts. Go to the current docs.

AdsApp.​AdGroupTargeting

Stay organized with collections Save and categorize content based on your preferences.
Provides access to ad group-level targeting criteria: audiences.

Methods:

MemberTypeDescription
audiences AdsApp.SearchAdGroupAudienceSelector Specializes this selector to return SearchAdGroupAudience criteria.
excludedAudiences AdsApp.SearchAdGroupExcludedAudienceSelector Specializes this selector to return SearchAdGroupExcludedAudience criteria.
getTargetingSetting String Returns the current targeting setting of the specified criterion type group for this ad group.
newUserListBuilder AdsApp.SearchAdGroupAudienceBuilder Returns a new user list builder for this ad group.
setTargetingSetting void Sets the targeting setting for this ad group.

audiences()

Specializes this selector to return SearchAdGroupAudience criteria.

Return values:

TypeDescription
AdsApp.SearchAdGroupAudienceSelector A selector for SearchAdGroupAudience criteria.

excludedAudiences()

Specializes this selector to return SearchAdGroupExcludedAudience criteria.

Return values:

TypeDescription
AdsApp.SearchAdGroupExcludedAudienceSelector A selector for SearchAdGroupExcludedAudience criteria.

getTargetingSetting(criterionTypeGroup)

Returns the current targeting setting of the specified criterion type group for this ad group.

Currently the only supported criterion type group value is 'USER_INTEREST_AND_LIST'.

The returned setting will be either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE', corresponding to 'Bid only' and 'Target and bid', respectively.

For more information about criterion type groups, please see the Google Ads Reference article.

Arguments:

NameTypeDescription
criterionTypeGroup String The criterion type group to check.

Return values:

TypeDescription
String The targeting setting for the criterion type group, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'.

newUserListBuilder()

Returns a new user list builder for this ad group. When SearchAdGroupAudienceBuilder.build() is called, an audience will be added in this ad group. When SearchAdGroupAudienceBuilder.exclude() is called, an excluded audience will be added in this ad group.

Return values:

TypeDescription
AdsApp.SearchAdGroupAudienceBuilder The builder used to add or exclude an audience in the ad group.

setTargetingSetting(criterionTypeGroup, targetingSetting)

Sets the targeting setting for this ad group.

For more information about criterion type groups, please see the Google Ads Reference article.

Currently the targeting setting may be set for USER_INTEREST_AND_LIST criterion type group only.

Returns nothing.

Arguments:

NameTypeDescription
criterionTypeGroup String The criterion type group to receive the new setting.
targetingSetting String The new targeting setting, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'.