label

AI-generated Key Takeaways

• 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.

Help me build a query

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 description Output only. ID of the label. Read only. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 Type URL N/A Filterable True Selectable True Sortable False Repeated False

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.v20.enums.LabelStatusEnum.LabelStatus Filterable True Selectable True Sortable True Repeated False

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 Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 Type URL N/A Filterable True Selectable True Sortable True Repeated False