The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcementsGoogle group to stay up to date on upcoming enhancements and releases.
labelStay organized with collectionsSave and categorize content based on your preferences.
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.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fieldswill not segmentmetrics in yourSELECTclause.
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}
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],["The provided content describes the attributes of a \"label\" resource, which can be used in queries with the `customer` resource. Key label attributes include: `id` (read-only), `name` (required on creation, 1-80 characters), `resource_name` (specific format), `status` (read-only), `background_color` (HEX format), and `description` (max 200 characters). Each attribute has associated details such as data type, filtering, and sorting capabilities. Fields from the `customer` resource can be used in `SELECT` and `WHERE` clauses, but will not segment the metrics.\n"]]
