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](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/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.

#### 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?
No Yes, it is

|---|---|
| | Resource fields | |---| | [id](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#user_list.id) | | [name](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#user_list.name) | | [resource_name](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#user_list.resource_name) | | [type](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#user_list.type) | | | Segments | |---| | [date](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#segments.date) | | [keyword.ad_group_criterion](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#segments.keyword.ad_group_criterion) | | [keyword.info.match_type](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#segments.keyword.info.match_type) | | [keyword.info.text](https://developers.google.com/search-ads/reporting/api/reference/fields/v0/user_list#segments.keyword.info.text) | |

|---|
| | ## 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_BASEDEXTERNAL_REMARKETINGLOGICALREMARKETINGRULE_BASEDSIMILARUNKNOWNUNSPECIFIED ` | | Type URL | `google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |
| | ## segments.date || |---|---| | Field description | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. | | Category | `SEGMENT` | | Data Type | `DATE` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |
| | ## segments.keyword.ad_group_criterion || |---|---| | Field description | The AdGroupCriterion resource name. | | Category | `SEGMENT` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |
| | ## segments.keyword.info.match_type || |---|---| | Field description | The match type of the keyword. | | Category | `SEGMENT` | | Data Type | ` ENUM BROADEXACTPHRASEUNKNOWNUNSPECIFIED ` | | Type URL | `google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |
| | ## segments.keyword.info.text || |---|---| | Field description | The text of the keyword (at most 80 characters and 10 words). | | Category | `SEGMENT` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |