La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google searchads-api-announcements per non perderti i prossimi miglioramenti e release.
elenco_utenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Un elenco di utenti. Si tratta di un elenco di utenti a cui un cliente può indirizzare il targeting. La chiave univoca di un elenco utenti è costituita dai seguenti campi: id. Tieni presente che anche name deve essere univoco per gli elenchi utenti di proprietà di un determinato cliente, tranne in alcuni casi in cui access_reason è impostato su SHARED. La violazione del vincolo di unicità del nome genera l'errore: UserListError.INVALID_NAME.
I campi delle risorse precedenti possono essere selezionati insieme a questa
risorsa nelle clausole SELECT e WHERE. Questi campi non segmenteranno
le metriche nella clausola SELECT.
user_list.id
Descrizione del campo
ID dell'elenco di utenti.
Categoria
ATTRIBUTE
Tipo di dati
INT64
Digita l'URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
Vero
Ripetuto
Falso
user_list.name
Descrizione del campo
Nome di questo elenco di utenti. Univoco per elenco utenti, tranne in alcuni casi in cui un elenco utenti con lo stesso nome ha access_reason impostato su SHARED.
Categoria
ATTRIBUTE
Tipo di dati
STRING
Digita l'URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
Vero
Ripetuto
Falso
user_list.resource_name
Descrizione del campo
Il nome risorsa dell'elenco utenti. I nomi delle risorse degli elenchi di utenti hanno il seguente formato: customers/{customer_id}/userLists/{user_list_id}
Categoria
ATTRIBUTE
Tipo di dati
RESOURCE_NAME
Digita l'URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
Falso
Ripetuto
Falso
user_list.type
Descrizione del campo
Il tipo di elenco. Questo campo è di sola lettura.
[null,null,["Ultimo aggiornamento 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"]]
