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.
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.
user_list.id
Descripción del campo
Es el ID de la lista de usuarios.
Categoría
ATTRIBUTE
Tipo de datos
INT64
Escribe la URL
N/A
Filtrable
Verdadero
Seleccionable
Verdadero
Ordenable
Verdadero
Repetido
Falso
user_list.name
Descripción del campo
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-03-10 (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"]]