To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

ad_group_ad_label

AI-generated Key Takeaways

An ad group ad label represents a relationship between an ad group ad and a label.
You can select fields from ad group, ad group ad, campaign, customer, and label resources when querying ad group ad label information.
Fields from attributed resources will not segment metrics in your SELECT clause.
The ad_group_ad_label.ad_group_ad field indicates the ad group ad to which the label is attached and is immutable.
The ad_group_ad_label.label field represents the immutable label assigned to the ad group ad.
The ad_group_ad_label.resource_name is an immutable resource name with a specific format.

A relationship between an ad group ad and a label.

Attributed resources
ad_group
ad_group_ad
campaign
customer
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.

ad_group_ad_label.ad_group_ad
Field description	Immutable. The ad group ad 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_ad_label.label
Field description	Immutable. The label assigned to the ad group ad.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_ad_label.resource_name
Field description	Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	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-10-16 UTC.

Blog
Visit our blog for important announcements.
Forum
Interact with our community of developer experts.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.

ad_group_ad_label Stay organized with collections Save and categorize content based on your preferences.

AI-generated Key Takeaways

ad_group_ad_label.ad_group_ad

ad_group_ad_label.label

ad_group_ad_label.resource_name

ad_group_ad_label