customer_label

  • This resource represents the relationship between a customer and a label, where the customer may not have access to all attached labels.

  • Additional CustomerLabels can be returned by increasing permissions with login-customer-id.

  • The customer resource can be selected along with this resource in SELECT and WHERE clauses, but will not segment metrics.

  • The customer_label.customer field is the read-only resource name of the customer to which the label is attached and is filterable, selectable, and sortable.

  • The customer_label.label field is the resource name of the label assigned to the customer and is filterable and selectable.

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.

Attributed resources
customer

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 descriptionOutput only. The resource name of the customer to which the label is attached. Read only.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

customer_label.label

Field descriptionOutput 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.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

customer_label.resource_name

Field descriptionImmutable. Name of the resource. Customer label resource names have the form:customers/{customer_id}/customerLabels/{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 2026-01-29 UTC.