La nueva API de informes de Search Ads 360 ya está disponible. Únete al grupo de Google searchads-api-announcements para mantenerte al tanto de las próximas mejoras y lanzamientos.
Los campos de los recursos anteriores se pueden seleccionar junto con este
recurso en las cláusulas SELECT y WHERE. Estos campos no segmentarán las métricas en la cláusula SELECT.
user_list.id
Descripción del campo
Es el ID de la lista de usuarios.
Categoría
ATTRIBUTE
Tipo de datos
INT64
Escribir URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Se puede ordenar
Verdadero
Repetido
Falso
user_list.name
Descripción del campo
Nombre de esta lista de usuarios. Según su access_reason, el nombre de la lista de usuarios puede no ser único (por ejemplo, si access_reason=SHARED)
Categoría
ATTRIBUTE
Tipo de datos
STRING
Escribir URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Se puede ordenar
Verdadero
Repetido
Falso
user_list.resource_name
Descripción del campo
El nombre del recurso de la lista de usuarios. Los nombres de recursos de la lista de usuarios tienen el siguiente formato: customers/{customer_id}/userLists/{user_list_id}
Categoría
ATTRIBUTE
Tipo de datos
RESOURCE_NAME
Escribir URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Se puede ordenar
Falso
Repetido
Falso
user_list.type
Descripción del campo
Es el tipo de esta lista. Este campo es de solo lectura.
[null,null,["Última actualización: 2025-08-29 (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 | |"]]
