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