label
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
A label.
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.
label.id
Field description Output only. ID of the label. Read only.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
label.name
Field description The 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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as label.id .
label.resource_name
Field description Immutable. Name of the resource.
Label resource names have the form:
customers/{customer_id}/labels/{label_id}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as label.id .
label.status
Field description Output only. Status of the label. Read only.
Category ATTRIBUTE
Data Type ENUM
ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.LabelStatusEnum.LabelStatus
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as label.id .
label.text_label.background_color
Field description Background 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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as label.id .
label.text_label.description
Field description A short description of the label. The length must be no more than 200
characters.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as label.id .
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-11-17 UTC.
[null,null,["Last updated 2026-11-17 UTC."],[],[]]