Google Ads API is returning to beta status. Please read our blog post for more details.

label

The label referenced in the query.
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 (if exist).

label.id

Field descriptionId of the label. Read only.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

label.resource_name

Field descriptionName 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 descriptionStatus of the label. Read only.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v2.enums.LabelStatusEnum.LabelStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

label.text_label.background_color

Field descriptionBackground color of the label in RGB 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 URLgoogle.protobuf.StringValue
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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse