The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
ad_group_criterion_label
Stay organized with collections
Save and categorize content based on your preferences.
Page Summary
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.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT clause.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields of ad_group_criterion_label.
However, when you specify ad_group_criterion_label in the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used when ad_group_criterion_label is specified in the FROM clause.
Is ad_group_criterion_label specified in the FROM clause of your query?
The ad group criterion to which the label is attached.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
ad_group_criterion_label.label
Field description
The label assigned to the ad group criterion.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
ad_group_criterion_label.owner_customer_id
Field description
The ID of the Customer which owns the label.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
ad_group_criterion_label.resource_name
Field description
The 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}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-05-11 UTC."],[],["This content details the relationship between ad group criteria and labels, focusing on the `ad_group_criterion_label` resource. Key information includes the ability to select fields from related resources like `ad_group`, `label`, `campaign`, and `customer`. The resource allows filtering and selecting, it contains the `ad_group_criterion` to which a label is attached, the label itself, the owning customer ID, and the resource name. The metrics of the select statement are not segmented.\n"]]
