The new Search Ads 360 Reporting API is currently available as an open beta release. 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.

A user list. This is a list of users a customer may target.

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.

user_list.id

Field descriptionOutput only. Id of the user list.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

user_list.name

Field descriptionName of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

user_list.resource_name

Field descriptionImmutable. The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

user_list.type

Field descriptionOutput only. Type of this list. This field is read-only.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.searchads360.v0.enums.UserListTypeEnum.UserListType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse