> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v25** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/fields/latest/customer_label).

[Help me build a query](https://developers.google.com/google-ads/api/fields/v25/customer_label_query_builder.md.txt) [Proto definition ![on GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v25/resources/customer_label.proto)

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](https://developers.google.com/google-ads/api/fields/v25/customer.md.txt) |

Fields from the preceding resources can be selected along with this
resource in your `SELECT` and `WHERE` clauses. These fields do **not** segment
metrics in your `SELECT` clause.

## customer_label.customer

Field descriptionOutput only. The resource name of the customer to which the label is
attached. This field should not be set when creating a new `CustomerLabel`.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [customer_label](https://developers.google.com/google-ads/api/fields/v25/customer_label.md.txt)

## customer_label.label

Field descriptionOutput only. The resource name of the label assigned to the customer.
This field should not be set when creating a new `CustomerLabel`.

Note: the Customer ID portion of the label resource name is not
validated when creating a new `CustomerLabel`.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [customer_label](https://developers.google.com/google-ads/api/fields/v25/customer_label.md.txt)

## customer_label.resource_name

Field descriptionImmutable. Name of the resource.
Customer label resource names have the form:
`customers/{customer_id}/customerLabels/{label_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [customer_label.label](https://developers.google.com/google-ads/api/fields/v25/customer_label.md.txt#customer_label.label).