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_ad_label

  • Defines the relationship between an ad group ad and a label, allowing for organization and categorization within Google Ads.

  • Enables retrieval of data for reporting and analysis by selecting fields from linked resources like ad group, ad group ad, campaign, customer, and label.

  • Provides information on the ad group ad label resource, including its attributes, relationships, and resource name structure.

  • Offers details about the ad group ad label's fields, such as ad group ad, label, customer ID, and resource name, with their respective descriptions, data types, and properties.

  • Allows filtering, selection, and sorting based on these fields to customize data retrieval and analysis, but these fields won't segment metrics.

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 fieldswill not segment metrics in yourSELECT clause.

ad_group_ad_label.ad_group_ad

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

ad_group_ad_label.label

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

ad_group_ad_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_ad_label.resource_name

Field descriptionThe resource name of the ad group ad label. Ad group ad label resource names have the form:customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_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.