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.
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.
user_list.id
Field description
Id of the user list.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
user_list.name
Field description
Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
user_list.resource_name
Field description
The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eA user list is a list of users a customer may target for advertising.\u003c/p\u003e\n"],["\u003cp\u003eUser list data includes an ID, name, resource name and type.\u003c/p\u003e\n"],["\u003cp\u003eUser list resource names follow the format: \u003ccode\u003ecustomers/{customer_id}/userLists/{user_list_id}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUser list types include CRM-based, external remarketing, logical, remarketing, rule-based, and similar.\u003c/p\u003e\n"]]],["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"],null,["# user_list\n\nA user list. This is a list of users a customer may target.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | user_list.id ------------ || |-------------------|----------------------| | Field description | Id of the user list. | | Category | `ATTRIBUTE` | | Data Type | `INT64` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | user_list.name -------------- || |-------------------|-------------------------------------------------------------------------------------------------------------------------------------| | Field description | Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED) | | Category | `ATTRIBUTE` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | user_list.resource_name ----------------------- || |-------------------|--------------------------------------------------------------------------------------------------------------------------------| | Field description | The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | user_list.type -------------- || |-------------------|-------------------------------------------------------------------------------------------------------| | Field description | Type of this list. This field is read-only. | | Category | `ATTRIBUTE` | | Data Type | ` `ENUM CRM_BASED EXTERNAL_REMARKETING LOGICAL REMARKETING RULE_BASED SIMILAR UNKNOWN UNSPECIFIED ` ` | | Type URL | `google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |"]]
