The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

ad_group_criterion_label

  • Defines the relationship between an ad group criterion and a label, allowing for organization and filtering.

  • Allows for selection of fields from related resources (ad group, ad group criterion, campaign, customer, label) in queries without segmenting metrics.

  • Provides details about the ad group criterion label resource, including its fields, data types, and properties like filterability and selectability.

  • Identifies key fields such as the ad group criterion, the assigned label, and the customer owning the label.

  • Specifies the resource name format for ad group criterion labels:customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}.

A relationship between an ad group criterion and a label.

Attributed resources
ad_group
ad_group_criterion
campaign
customer
label

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fieldswill not segment metrics in yourSELECT clause.

ad_group_criterion_label.ad_group_criterion

Field descriptionThe ad group criterion to which the label is attached.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group_criterion_label.label

Field descriptionThe label assigned to the ad group criterion.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group_criterion_label.owner_customer_id

Field descriptionThe ID of the Customer which owns the label.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group_criterion_label.resource_name

Field descriptionThe resource name of the ad group criterion label. Ad group criterion label resource names have the form:customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-12 UTC.