Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ユーザーリスト。これは、顧客がターゲットにできるユーザーのリストです。ユーザーリストの一意のキーは、id フィールドで構成されます。なお、access_reason が SHARED に設定されている場合を除き、特定の顧客が所有するユーザーリストの name も一意である必要があります。一意の名前の制約に違反すると、エラー UserListError.INVALID_NAME が発生します。
上記のリソースのフィールドは、SELECT 句と WHERE 句でこの
リソースとともに選択できます。これらのフィールドは、句の指標を
セグメント化しませんSELECT 。
フィールド/セグメント/指標
このページには、user_list のフィールドと同じ SELECT 句に配置できるすべての指標とセグメントが表示されます。
ただし、FROM 句で user_list を指定すると、一部の指標とセグメント
は使用できません。
FROM 句で user_list を指定した場合に使用できるフィールドのみを表示するには、次のフィルタを使用します。
クエリの FROM 句で user_list を指定していますか？
いいえ
はい
user_list.id
フィールドの説明 ユーザーリストの ID。 カテゴリ ATTRIBUTEデータ型 INT64タイプ URL N/A可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
user_list.name
フィールドの説明 このユーザーリストの名前。同じ名前のユーザーリストの access_reason が SHARED に設定されている場合を除き、ユーザーリストごとに一意です。 カテゴリ ATTRIBUTEデータ型 STRINGタイプ URL N/A可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
user_list.resource_name
フィールドの説明 ユーザーリストのリソース名。ユーザーリストのリソース名の形式は customers/{customer_id}/userLists/{user_list_id} です。 カテゴリ ATTRIBUTEデータ型 RESOURCE_NAMEタイプ URL N/A可 正しい 選択可能 正しい Sortable False 繰り返し False
user_list.type
フィールドの説明 このリストのタイプ。このフィールドは読み取り専用です。 カテゴリ ATTRIBUTEデータ型
ENUM
CRM_BASED
EXTERNAL_REMARKETING
LOGICAL
REMARKETING
RULE_BASED
SIMILAR
UNKNOWN
UNSPECIFIED
タイプ URL google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
segments.date
フィールドの説明 指標が適用される日付。yyyy-MM-dd 形式（例: 2018-04-17）。 カテゴリ SEGMENTデータ型 DATEタイプ URL N/A可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
segments.keyword.ad_group_criterion
フィールドの説明 AdGroupCriterion リソース名。 カテゴリ SEGMENTデータ型 RESOURCE_NAMEタイプ URL N/A可 正しい 選択可能 正しい Sortable False 繰り返し False
segments.keyword.info.match_type
フィールドの説明 キーワードのマッチ タイプです。 カテゴリ SEGMENTデータ型
ENUM
BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
タイプ URL google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
segments.keyword.info.text
フィールドの説明 キーワードのテキスト（最大 80 文字、10 単語）。 カテゴリ SEGMENTデータ型 STRINGタイプ URL N/A可 正しい 選択可能 正しい Sortable 正しい 繰り返し False
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2026-05-11 UTC。
[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"]]
