The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

type AdGroupCriterion (v201809)

Service
AdGroupCriterionService
Dependencies
AdGroupCriterionOperation AdGroupCriterionPage AdGroupCriterionReturnValue
▼
AdGroupCriterion
Inheritance
AdGroupCriterion
▼
BiddableAdGroupCriterion NegativeAdGroupCriterion

Represents a criterion in an ad group, used with AdGroupCriterionService.

Namespace
https://adwords.google.com/api/adwords/cm/v201809

Field

adGroupId

xsd:long

The ad group this criterion is in.

This field can be selected using the value "AdGroupId".
This field can be filtered on.
This field is required and should not be null.

criterionUse

CriterionUse

Enumerations
BIDDABLE
Biddable (positive) criterion
NEGATIVE
Negative criterion

This field can be selected using the value "CriterionUse".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

criterion

  1. Criterion
    1. AgeRange
    2. AppPaymentModel
    3. CriterionCustomAffinity
    4. CriterionCustomIntent
    5. Gender
    6. IncomeRange
    7. Keyword
    8. MobileAppCategory
    9. MobileApplication
    10. Parent
    11. Placement
    12. ProductPartition
    13. CriterionUserInterest
    14. CriterionUserList
    15. Vertical
    16. Webpage
    17. YouTubeChannel
    18. YouTubeVideo

The criterion part of the ad group criterion.

This field is required and should not be null.

labels

  1. Label[]
    1. TextLabel

Labels that are attached to the AdGroupCriterion. To associate an existing Label to an existing AdGroupCriterion, use AdGroupCriterionService.mutateLabel with ADD operator. To remove an associated Label from the AdGroupCriterion, use AdGroupCriterionService.mutateLabel with REMOVE operator. To filter on Labels, use one of Predicate.Operator.CONTAINS_ALL, Predicate.Operator.CONTAINS_ANY, Predicate.Operator.CONTAINS_NONE operators with a list of Label ids.

This field can be selected using the value "Labels".
This field can be filtered on.
This field may not be set for campaign channel subtype UNIVERSAL_APP_CAMPAIGN.
This field is read only and will be ignored when sent to the API for the following Operators: REMOVE and SET.

forwardCompatibilityMap

String_StringMapEntry[]

This Map provides a place to put new features and settings in older versions of the AdWords API in the rare instance we need to introduce a new feature in an older version. It is presently unused. Do not set a value.

baseCampaignId

xsd:long

ID of the base campaign from which this draft/trial ad group criterion was created. This field is only returned on get requests.

This field can be selected using the value "BaseCampaignId".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

baseAdGroupId

xsd:long

ID of the base ad group from which this draft/trial ad group criterion was created. For base ad groups this is equal to the ad group ID. If the ad group was created in the draft or trial and has no corresponding base ad group, this field is null. This field is only returned on get requests.

This field can be selected using the value "BaseAdGroupId".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

AdGroupCriterion.Type

xsd:string

Indicates that this instance is a subtype of AdGroupCriterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.