The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
user_list
Stay organized with collections
Save and categorize content based on your preferences.
Page Summary
A user list is a list of users a customer may target for advertising.
User list data includes an ID, name, resource name and type.
User list resource names follow the format: customers/{customer_id}/userLists/{user_list_id}.
User list types include CRM-based, external remarketing, logical, remarketing, rule-based, and similar.
A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: id. Note that the name must also be unique for user lists owned by a given customer, except in some cases where access_reason is set to SHARED. Violating the unique name constraint produces error: UserListError.INVALID_NAME.
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.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields of user_list.
However, when you specify user_list in the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used when user_list is specified in the FROM clause.
Is user_list specified in the FROM clause of your query?
[[["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 2026-05-11 UTC."],[],["This document describes user lists, which are targetable by customers, and associated data. Key fields include `user_list.id` (unique ID), `user_list.name` (potentially non-unique name), `user_list.resource_name` (resource identifier), and `user_list.type` (list classification, e.g., CRM_BASED). These fields, categorized as attributes, can be used in SELECT and WHERE clauses for filtering and retrieval, but will not segment metrics. The related resource is `customer`, which can also be included.\n"]]
