[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v26/label_query_builder) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v26/resources/label.proto)

A label.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v26/customer) |

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

## label.id

Field descriptionOutput only. ID of the label. Read only.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)

## label.name

Field descriptionThe name of the label.

This field is required and should not be empty when creating a new label.

The length of this string should be between 1 and 80, inclusive.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)

## label.resource_name

Field descriptionImmutable. Name of the resource.
Label resource names have the form:
`customers/{customer_id}/labels/{label_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)

## label.status

Field descriptionOutput only. Status of the label. Read only.
Category`ATTRIBUTE` Data Type `ENUM`
`ENABLED``REMOVED``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/LabelStatusEnum.LabelStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)

## label.text_label.background_color

Field descriptionBackground color of the label in HEX format. This string must match the
regular expression '\^#(\[a-fA-F0-9\]{6}\|\[a-fA-F0-9\]{3})$'.
Note: The background color may not be visible for manager accounts.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)

## label.text_label.description

Field descriptionA short description of the label. The length must be no more than 200
characters.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[ad_group_ad_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_ad_label) [ad_group_criterion_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_criterion_label) [ad_group_label](https://developers.google.com/google-ads/api/fields/v26/ad_group_label) [campaign_label](https://developers.google.com/google-ads/api/fields/v26/campaign_label) [label](https://developers.google.com/google-ads/api/fields/v26/label)