La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google searchads-api-announcements per non perderti i prossimi miglioramenti e release.
I campi delle risorse precedenti possono essere selezionati insieme a questa risorsa nelle clausole SELECT e WHERE. Questi campi non segmentano le metriche nella clausola SELECT.
user_list.id
Descrizione del campo
ID dell'elenco di utenti.
Categoria
ATTRIBUTE
Tipo di dati
INT64
Digita un URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
Vero
Ripetuto
falso
user_list.name
Descrizione del campo
Nome di questo elenco di utenti. A seconda di access_reason, il nome dell'elenco utenti potrebbe non essere univoco (ad esempio, access_reason=SHARED)
Categoria
ATTRIBUTE
Tipo di dati
STRING
Digita un URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
Vero
Ripetuto
falso
user_list.resource_name
Descrizione del campo
Il nome della risorsa dell'elenco di utenti. Il formato dei nomi delle risorse degli elenchi di utenti è: customers/{customer_id}/userLists/{user_list_id}
Categoria
ATTRIBUTE
Tipo di dati
RESOURCE_NAME
Digita un URL
N/A
Filtrabile
Vero
Selezionabile
Vero
Sortable
falso
Ripetuto
falso
user_list.type
Descrizione del campo
Tipo di questo elenco. Questo campo è di sola lettura.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eA user list is a list of users a customer may target for advertising.\u003c/p\u003e\n"],["\u003cp\u003eUser list data includes an ID, name, resource name and type.\u003c/p\u003e\n"],["\u003cp\u003eUser list resource names follow the format: \u003ccode\u003ecustomers/{customer_id}/userLists/{user_list_id}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUser list types include CRM-based, external remarketing, logical, remarketing, rule-based, and similar.\u003c/p\u003e\n"]]],["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"],null,["# user_list\n\nA user list. This is a list of users a customer may target.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | user_list.id ------------ || |-------------------|----------------------| | Field description | Id of the user list. | | Category | `ATTRIBUTE` | | Data Type | `INT64` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | user_list.name -------------- || |-------------------|-------------------------------------------------------------------------------------------------------------------------------------| | Field description | Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED) | | Category | `ATTRIBUTE` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | user_list.resource_name ----------------------- || |-------------------|--------------------------------------------------------------------------------------------------------------------------------| | Field description | The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | user_list.type -------------- || |-------------------|-------------------------------------------------------------------------------------------------------| | Field description | Type of this list. This field is read-only. | | Category | `ATTRIBUTE` | | Data Type | ` `ENUM CRM_BASED EXTERNAL_REMARKETING LOGICAL REMARKETING RULE_BASED SIMILAR UNKNOWN UNSPECIFIED ` ` | | Type URL | `google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |"]]
