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.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Es una lista de usuarios. Es una lista de usuarios a los que un cliente puede segmentar sus anuncios. La clave única de una lista de usuarios consta de los siguientes campos: id. Ten en cuenta que el name también debe ser único para las listas de usuarios que pertenecen a un cliente determinado, excepto en algunos casos en los que access_reason se establece en SHARED. Si se incumple la restricción de nombre único, se produce el error UserListError.INVALID_NAME.
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 tu cláusula SELECT.
Campos, segmentos y métricas
En esta página, se muestran todas las métricas y los segmentos que se pueden incluir en la misma cláusula SELECT que los campos de user_list.
Sin embargo, cuando especificas user_list en la cláusula FROM, no se pueden usar algunas métricas ni segmentos.
Usa el siguiente filtro para mostrar solo los campos que se pueden usar cuando se especifica user_list en la cláusula FROM.
¿Se especifica user_list en la cláusula FROM de tu consulta?
Es el nombre de esta lista de usuarios. Es único por lista de usuarios, excepto en algunos casos en los que una lista de usuarios con el mismo nombre tiene access_reason establecido en SHARED.
Categoría
ATTRIBUTE
Tipo de datos
STRING
Escribe la URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Ordenable
Verdadero
Repetido
Falso
user_list.resource_name
Descripción del campo
Es el nombre del recurso de la lista de usuarios. Los nombres de recursos de las listas de usuarios tienen el siguiente formato: customers/{customer_id}/userLists/{user_list_id}
Categoría
ATTRIBUTE
Tipo de datos
RESOURCE_NAME
Escribe la URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Ordenable
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: 2026-05-11 (UTC)"],[],["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"]]
