AdsApp.​ShoppingAdGroupTargeting

Access to ad group-level targeting criteria.

For instance, to select all audiences targeted by an ad group you might use:

var adgroup = AdsApp.shoppingAdGroups().get().next();
var audiences = adgroup.targeting().audiences().get();
while (audiences.hasNext()) {
  var audience = audiences.next();
}

Methods:

MemberTypeDescription
audiences AdsApp.ShoppingAdGroupAudienceSelector Specializes this selector to return ShoppingAdGroupAudience criteria.
getTargetingSetting String Returns the current targeting setting of the specified criterion type group for this shopping ad group.
newUserListBuilder AdsApp.ShoppingAdGroupAudienceBuilder Returns a new user list audience builder for this ad group.
setTargetingSetting void Sets the targeting setting for this ad group.

audiences()

Specializes this selector to return ShoppingAdGroupAudience criteria.

Return values:

TypeDescription
AdsApp.ShoppingAdGroupAudienceSelector A selector for ShoppingAdGroupAudience criteria.

getTargetingSetting(criterionTypeGroup)

Returns the current targeting setting of the specified criterion type group for this shopping 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.

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 audience builder for this ad group. When ShoppingAdGroupAudienceBuilder.build() is called, an audience will be added in this ad group.

Return values:

TypeDescription
AdsApp.ShoppingAdGroupAudienceBuilder The builder used to add a new audience in the ad group.

setTargetingSetting(criterionTypeGroup, targetingSetting)

Sets the targeting setting for this ad group.

Currently the targeting setting may be set for the 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'.