user_list

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.

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 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. Unique per user list, except in some cases where a user list of the same name has access_reason set to 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} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

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