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.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Liste d'utilisateurs. Il s'agit d'une liste d'utilisateurs qu'un client peut cibler. La clé unique d'une liste d'utilisateurs se compose des champs suivants : id. Notez que le name doit également être unique pour les listes d'utilisateurs appartenant à un client donné, sauf dans certains cas où access_reason est défini sur SHARED. Si vous ne respectez pas la contrainte de nom unique, l'erreur suivante s'affiche : UserListError.INVALID_NAME.
Les champs des ressources ci-dessus peuvent être sélectionnés avec cette
ressource dans vos clauses SELECT et WHERE. Ces champs ne segmenteront pas
les métriques dans votre SELECT clause.
Champs/Segments/Métriques
Cette page présente toutes les métriques et tous les segments qui peuvent être placés dans la même clause SELECT que les champs de user_list.
Toutefois, lorsque vous spécifiez user_list dans la clause FROM, certaines métriques et certains segments
ne peuvent pas être utilisés.
Utilisez le filtre suivant pour n'afficher que les champs qui peuvent être utilisés lorsque user_list est spécifié dans la clause FROM.
user_list est-il spécifié dans la clause FROM de votre requête ?
Nom de cette liste d'utilisateurs. Unique par liste d'utilisateurs, sauf dans certains cas où une liste d'utilisateurs portant le même nom a access_reason défini sur SHARED.
Catégorie
ATTRIBUTE
Type de données
STRING
Type d'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 ressource 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
Type d'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.
Texte du mot clé (au maximum 80 caractères et 10 mots).
Catégorie
SEGMENT
Type de données
STRING
Type d'URL
N/A
Filtrable
Vrai
Sélectionnable
Vrai
Sortable
Vrai
Répété
Faux
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 2026/05/11 (UTC).
[null,null,["Dernière mise à jour le 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"]]
