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.
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. 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.
user_list.id
Descrição do campo
ID da lista de usuários.
Categoria
ATTRIBUTE
Tipo de dados
INT64
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
user_list.name
Descrição do campo
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-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"]]
