label

  • Labels are used for organizing and categorizing various entities within Google Ads.

  • Label data can be combined with customer resource data without segmenting metrics in your SELECT clause.

  • Key fields available for labels include ID, name, resource name, status, background color, and description.

  • The label resource name follows the format customers/{customer_id}/labels/{label_id} and is immutable.

  • The label status is output only and indicates the current state of the label.

A label.

Attributed resources
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.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

label.resource_name

Field descriptionImmutable. Name of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

label.status

Field descriptionOutput only. Status of the label. Read only.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.LabelStatusEnum.LabelStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

label.text_label.description

Field descriptionA short description of the label. The length must be no more than 200 characters.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse