Join us live onDiscord on the Google Advertising and Measurement Community server and onYouTube on February 26th at 10:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.
customer_label Stay organized with collections Save and categorize content based on your preferences.
Page Summary
Customer label represents a relationship between a customer and a label, but the customer may not have access to all attached labels unless permissions are increased with login-customer-id.
The customer resource can be selected along with customer label, but its fields will not segment metrics in your SELECT clause.
The fields available for customer label arecustomer_label.customer,customer_label.label, andcustomer_label.resource_name.
customer_label.customer andcustomer_label.label are resource names that are output only, whilecustomer_label.resource_name is immutable.
Represents a relationship between a customer and a label. This customer may not have access to all the labels attached to it. Additional CustomerLabels may be returned by increasing permissions with login-customer-id.
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.
customer_label.customer
Field description
Output only. The resource name of the customer to which the label is attached. Read only.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
customer_label.label
Field description
Output only. The resource name of the label assigned to the customer. Note: the Customer ID portion of the label resource name is not validated when creating a new CustomerLabel.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
customer_label.resource_name
Field description
Immutable. Name of the resource. Customer label resource names have the form:customers/{customer_id}/customerLabels/{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-01-29 UTC."],[],[]]
