[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\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 | |"]]