label

AI-generated Key Takeaways

• The Label resource allows you to define and apply labels to different entities within your Search Ads 360 account, such as campaigns, ad groups, and keywords, for organizational purposes.

• You can retrieve information about labels, including their ID, name, status, and associated color and description if defined as a text label, using the fields outlined in the table.

• These fields can be used for filtering and sorting data in your queries, enabling you to segment and analyze data based on label assignments without affecting the aggregation of metrics.

• Note that the background color for text labels might not be visible in manager accounts.

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 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 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 Status of the label. Read only. Category ATTRIBUTE Data Type ENUM ENABLED REMOVED UNKNOWN UNSPECIFIED Type URL google.ads.searchads360.v0.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