AdsApp.ShoppingAdGroupTargeting
Stay organized with collections
Save and categorize content based on your preferences.
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:
audiences()
Specializes this selector to return
ShoppingAdGroupAudience
criteria.
Return values:
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:
Name | Type | Description |
criterionTypeGroup |
String |
The criterion type group to check. |
Return values:
Type | Description |
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:
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:
Name | Type | Description |
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'. |
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-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eAccess and manage targeting criteria for Shopping ad groups within Google Ads.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the provided methods to retrieve, add, and modify audience targeting settings.\u003c/p\u003e\n"],["\u003cp\u003eLeverage the \u003ccode\u003etargetingSetting\u003c/code\u003e property to control bid-only or target-and-bid strategies for user lists and interests.\u003c/p\u003e\n"],["\u003cp\u003eScript examples demonstrate how to interact with ad group targeting using the Google Ads Scripts API.\u003c/p\u003e\n"]]],[],null,["# AdsApp.ShoppingAdGroupTargeting\n\nAccess to ad group-level targeting criteria.\n\nFor instance, to select all audiences targeted by an ad group you might\nuse:\n\n```gdscript\nvar adgroup = AdsApp.shoppingAdGroups().get().next();\nvar audiences = adgroup.targeting().audiences().get();\nwhile (audiences.hasNext()) {\n var audience = audiences.next();\n}\n```\n\n### Methods:\n\n| Member | Type | Description |\n|-----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| [audiences()](#audiences) | [AdsApp.ShoppingAdGroupAudienceSelector](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudienceselector) | Specializes this selector to return [ShoppingAdGroupAudience](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudience) criteria. |\n| [getTargetingSetting(criterionTypeGroup)](#getTargetingSetting_criterionTypeGroup) | `String` | Returns the current targeting setting of the specified criterion type group for this shopping ad group. |\n| [newUserListBuilder()](#newUserListBuilder) | [AdsApp.ShoppingAdGroupAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudiencebuilder) | Returns a new user list audience builder for this ad group. |\n| [setTargetingSetting(criterionTypeGroup, targetingSetting)](#setTargetingSetting_criterionTypeGroup-targetingSetting) | `void` | Sets the targeting setting for this ad group. |\n\n`audiences()`\n-------------\n\nSpecializes this selector to return [ShoppingAdGroupAudience](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudience) criteria.\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [AdsApp.ShoppingAdGroupAudienceSelector](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudienceselector) | A selector for [ShoppingAdGroupAudience](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudience) criteria. |\n\n`getTargetingSetting(criterionTypeGroup)`\n-----------------------------------------\n\nReturns the current targeting setting of the specified criterion type group for this shopping ad group.\n\nCurrently the only supported criterion type group value is\nUSER_INTEREST_AND_LIST.\n\nThe returned setting will be either 'TARGET_ALL_TRUE' or\n'TARGET_ALL_FALSE', corresponding to 'Bid only' and 'Target and bid',\nrespectively.\n\n### Arguments:\n\n| Name | Type | Description |\n|--------------------|----------|------------------------------------|\n| criterionTypeGroup | `String` | The criterion type group to check. |\n\n### Return values:\n\n| Type | Description |\n|----------|-----------------------------------------------------------------------------------------------------|\n| `String` | The targeting setting for the criterion type group, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'. |\n\n`newUserListBuilder()`\n----------------------\n\nReturns a new user list audience builder for this ad group. When [ShoppingAdGroupAudienceBuilder.build()](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudiencebuilder#build) is called, an audience will be added in this ad group.\n\n### Return values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|\n| [AdsApp.ShoppingAdGroupAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingadgroupaudiencebuilder) | The builder used to add a new audience in the ad group. |\n\n`setTargetingSetting(criterionTypeGroup, targetingSetting)`\n-----------------------------------------------------------\n\nSets the targeting setting for this ad group.\n\nCurrently the targeting setting may be set for the\nUSER_INTEREST_AND_LIST criterion type group only.\n\nReturns nothing.\n\n### Arguments:\n\n| Name | Type | Description |\n|--------------------|----------|----------------------------------------------------------------------------|\n| criterionTypeGroup | `String` | The criterion type group to receive the new setting. |\n| targetingSetting | `String` | The new targeting setting, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'. |"]]