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.
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_label.ad_group
Field description
The ad group 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_label.label
Field description
The 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_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_label.resource_name
Field description
The resource name of the ad group label. Ad group label resource names have the form:customers/{customer_id}/adGroupLabels/{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."],[[["\u003cp\u003eAn ad group label represents the relationship between an ad group and a label, allowing for categorization and organization.\u003c/p\u003e\n"],["\u003cp\u003eKey selectable fields include the ad group, the label, the owner customer ID, and the resource name, which can be used for filtering and reporting.\u003c/p\u003e\n"],["\u003cp\u003eThe fields provided offer insights into the ad group and label association without segmenting metrics, primarily serving as identifiers and attributes.\u003c/p\u003e\n"],["\u003cp\u003eResource names for ad group labels follow a specific format: \u003ccode\u003ecustomers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes the `ad_group_label` resource, representing the association between an ad group and a label. Key information includes the `ad_group` and `label` resource names, which can be selected and filtered. The `owner_customer_id` reveals the label's owning customer, and the `resource_name` provides a unique identifier. These fields can be used in queries but will not segment metrics. Also, there is data on the attributed resources that can be selected in the `SELECT` and `WHERE` clause.\n"],null,["# ad_group_label\n\nA relationship between an ad group and a label.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [ad_group](/search-ads/reporting/api/reference/fields/v0/ad_group) |\n| [campaign](/search-ads/reporting/api/reference/fields/v0/campaign) |\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n| [label](/search-ads/reporting/api/reference/fields/v0/label) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | ad_group_label.ad_group ----------------------- || |-------------------|----------------------------------------------| | Field description | The ad group to which the label is attached. | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | ad_group_label.label -------------------- || |-------------------|-------------------------------------| | Field description | The label assigned to the ad group. | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | ad_group_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 | |\n| | ad_group_label.resource_name ---------------------------- || |-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| | Field description | The resource name of the ad group label. Ad group label resource names have the form: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |"]]
