The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcementsGoogle group to stay up to date on upcoming enhancements and releases.
ad_group_effective_labelStay organized with collectionsSave and categorize content based on your preferences.
AI-generated Key Takeaways
Ad group effective labels represent the relationship between an ad group and a label applied to it, either directly or through inheritance.
This relationship allows for the retrieval of ad group and label data through resource fields likead_group_effective_label.ad_groupandad_group_effective_label.label.
Thead_group_effective_label.resource_namefield provides a unique identifier for each ad group effective label relationship within a customer account.
You can use the provided fields in SELECT and WHERE clauses to filter and query data related to ad groups and their effective labels, but these fields won't segment metrics.
A relationship between an ad group and an effective label. An effective label is a label inherited or directly assigned to this ad group.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fieldswill not segmentmetrics in yourSELECTclause.
ad_group_effective_label.ad_group
Field description
The ad group to which the effective label is attached.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
ad_group_effective_label.label
Field description
The effective label assigned to the ad group.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
ad_group_effective_label.owner_customer_id
Field description
The ID of the Customer which owns the effective label.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
ad_group_effective_label.resource_name
Field description
The resource name of the ad group effective label. Ad group effective label resource names have the form:customers/{customer_id}/adGroupEffectiveLabels/{ad_group_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 2025-08-28 UTC."],[],["The content details the relationship between ad groups and their effective labels, which can be inherited or directly assigned. Key fields for this relationship include the ad group resource name, the effective label's resource name, the owner customer ID of the label, and the ad group effective label's resource name. These fields are attributes that can be selected and filtered in queries, but they do not segment metrics. Resources related are ad_group, campaign, customer, and label.\n"]]
