La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.
Les champs des ressources ci-dessus peuvent être sélectionnés avec cette ressource dans vos clauses SELECT et WHERE. Ces champs ne segmentent pas les métriques dans votre clause SELECT.
user_list.id
Description du champ
Identifiant de la liste d'utilisateurs.
Catégorie
ATTRIBUTE
Type de données
INT64
Saisir une URL
N/A
Filtrable
Vrai
Sélectionnable
Vrai
Sortable
Vrai
Répété
Faux
user_list.name
Description du champ
Nom de cette liste d'utilisateurs. Selon son motif d'accès (access_reason), le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED).
Catégorie
ATTRIBUTE
Type de données
STRING
Saisir une URL
N/A
Filtrable
Vrai
Sélectionnable
Vrai
Sortable
Vrai
Répété
Faux
user_list.resource_name
Description du champ
Nom de ressource de la liste d'utilisateurs. Les noms de ressources de la liste d'utilisateurs se présentent sous la forme suivante: customers/{customer_id}/userLists/{user_list_id}
Catégorie
ATTRIBUTE
Type de données
RESOURCE_NAME
Saisir une URL
N/A
Filtrable
Vrai
Sélectionnable
Vrai
Sortable
Faux
Répété
Faux
user_list.type
Description du champ
Type de cette liste. Ce champ est en lecture seule.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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 | |"]]
