A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google searchads-api-announcements para ficar por dentro das próximas melhorias e versões.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar. A chave exclusiva de uma lista de usuários consiste nos seguintes campos: id. Observe que o name também precisa ser exclusivo para listas de usuários de um determinado cliente, exceto em alguns casos em que access_reason é definido como SHARED. Violar a restrição de nome exclusivo produz o erro: UserListError.INVALID_NAME.
Os campos dos recursos acima podem ser selecionados com este recurso nas cláusulas SELECT e WHERE. Esses campos não vão segmentar métricas na cláusula SELECT.
Campos/segmentos/métricas
Esta página mostra todas as métricas e segmentos que podem ser colocados na mesma cláusula SELECT que os campos de user_list.
No entanto, quando você especifica user_list na cláusula FROM, algumas métricas e segmentos não podem ser usados.
Use o filtro a seguir para mostrar apenas os campos que podem ser usados quando user_list é especificado na cláusula FROM.
O user_list está especificado na cláusula FROM da sua consulta?
Nome desta lista de usuários. Exclusivo por lista de usuários, exceto em alguns casos em que uma lista de usuários com o mesmo nome tem access_reason definido como SHARED.
Categoria
ATTRIBUTE
Tipo de dados
STRING
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
user_list.resource_name
Descrição do campo
O nome do recurso da lista de usuários. Os nomes de recursos de lista de usuários têm o formato: customers/{customer_id}/userLists/{user_list_id}
[null,null,["Última atualização 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"]]
