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.
user_list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une 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 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 UserListError.INVALID_NAME s'affiche.
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 de votre clause SELECT.
user_list.id
Description du champ
ID 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. Unique par liste d'utilisateurs, sauf dans certains cas où une liste d'utilisateurs du même nom a la valeur SHARED pour access_reason.
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 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 2026/03/10 (UTC).
[null,null,["Dernière mise à jour le 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"]]