Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
用户列表。这是客户可能会定位到的用户列表。用户列表的唯一键由以下字段组成：id。请注意，对于给定客户拥有的用户列表，name 也必须是唯一的，但某些情况下 access_reason 设置为 SHARED 的除外。违反唯一名称约束会产生错误：UserListError.INVALID_NAME。
您可以选择上述资源中的字段，并将其与 SELECT 和 WHERE 子句中的此
资源一起使用。这些字段不会细分
`SELECT` 子句中的指标。SELECT
字段/细分/指标
此页面显示了可以与 user_list 的字段放在同一 SELECT 子句中的所有指标和细分。
不过，如果您在 FROM 子句中指定了 user_list，则无法使用某些指标和细分
。
使用以下过滤条件，仅显示在 FROM 子句中指定 user_list 时可以使用的字段。
您的查询的 FROM 子句中是否指定了 user_list？
否
是
user_list.id
字段说明 用户列表的 ID。 类别 ATTRIBUTE数据类型 INT64类型网址 N/A可过滤 正确 可选择 正确 可排序 正确 重复 错误
user_list.name
字段说明 此用户列表的名称。每个用户列表都是唯一的，但某些情况下，如果同名用户列表的 access_reason 设置为 SHARED，则例外。 类别 ATTRIBUTE数据类型 STRING类型网址 N/A可过滤 正确 可选择 正确 可排序 正确 重复 错误
user_list.resource_name
字段说明 用户列表的资源名称。用户列表资源名称的格式为：customers/{customer_id}/userLists/{user_list_id} 类别 ATTRIBUTE数据类型 RESOURCE_NAME类型网址 N/A可过滤 正确 可选择 正确 可排序 错误 重复 错误
user_list.type
字段说明 此列表的类型。此字段为只读字段。 类别 ATTRIBUTE数据类型
ENUM
CRM_BASED
EXTERNAL_REMARKETING
LOGICAL
REMARKETING
RULE_BASED
SIMILAR
UNKNOWN
UNSPECIFIED
类型网址 google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType可过滤 正确 可选择 正确 可排序 正确 重复 错误
segments.date
字段说明 指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。 类别 SEGMENT数据类型 DATE类型网址 N/A可过滤 正确 可选择 正确 可排序 正确 重复 错误
segments.keyword.ad_group_criterion
字段说明 AdGroupCriterion 资源名称。 类别 SEGMENT数据类型 RESOURCE_NAME类型网址 N/A可过滤 正确 可选择 正确 可排序 错误 重复 错误
segments.keyword.info.match_type
字段说明 关键字的匹配类型。 类别 SEGMENT数据类型
ENUM
BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
类型网址 google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType可过滤 正确 可选择 正确 可排序 正确 重复 错误
segments.keyword.info.text
字段说明 关键字文本（最多 80 个字符和 10 个字词）。 类别 SEGMENT数据类型 STRING类型网址 N/A可过滤 正确 可选择 正确 可排序 正确 重复 错误
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可，并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情，请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2026-05-11。
[null,null,["最后更新时间 (UTC)：2026-05-11。"],[],["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"]]
