Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
список_пользователей
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Список пользователей. Это список пользователей, на которых может ориентироваться клиент. Уникальный ключ списка пользователей состоит из следующих полей: id . Обратите внимание, что name также должно быть уникальным для списков пользователей, принадлежащих данному клиенту, за исключением некоторых случаев, когда access_reason установлено в SHARED . Нарушение ограничения уникального имени приводит к ошибке: UserListError.INVALID_NAME .
Поля из указанных выше ресурсов могут быть выбраны вместе с этим ресурсом в ваших предложениях SELECT и WHERE. Эти поля не будут использоваться для сегментации метрик в вашем предложении SELECT .
Поля/Сегменты/Метрики
На этой странице отображаются все метрики и сегменты, которые можно указать в том же предложении SELECT, что и поля user_list . Однако, если вы указываете user_list в предложении FROM, некоторые метрики и сегменты использовать нельзя. Используйте следующий фильтр, чтобы отобразить только те поля, которые можно использовать, если user_list указан в предложении FROM.
Указан ли user_list в предложении FROM вашего запроса?
Название этого списка пользователей. Уникальное для каждого списка пользователей, за исключением случаев, когда для списка пользователей с одинаковым именем access_reason установлен в SHARED .
Категория
ATTRIBUTE
Тип данных
STRING
Введите URL
N/A
Фильтруемый
Истинный
Выбираемый
Истинный
Сортируемый
Истинный
Повторный
ЛОЖЬ
user_list.resource_name
Описание поля
Имя ресурса списка пользователей. Имена ресурсов списка пользователей имеют вид: customers/{customer_id}/userLists/{user_list_id}
Категория
ATTRIBUTE
Тип данных
RESOURCE_NAME
Введите URL
N/A
Фильтруемый
Истинный
Выбираемый
Истинный
Сортируемый
ЛОЖЬ
Повторный
ЛОЖЬ
user_list.type
Описание поля
Тип этого списка. Это поле доступно только для чтения.
[null,null,["Последнее обновление: 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"]]
