使用者名單

使用者清單。這是顧客可鎖定的使用者名單。使用者名單的專屬鍵包含下列欄位：id。請注意，除了 access_reason 設為 SHARED 的例外狀況外，特定客戶擁有的使用者名單也必須有專屬的 name。違反專屬名稱限制會產生錯誤：UserListError.INVALID_NAME。

已歸因的資源
顧客

您可以在 SELECT 和 WHERE 子句中，選取上述資源的欄位，以及這個資源。這些欄位不會區隔 SELECT 子句中的指標。

欄位/區隔/指標

這個頁面會顯示所有可與 user_list 欄位放在同一個 SELECT 子句中的指標和區隔。 不過，在 FROM 子句中指定 user_list 時，無法使用部分指標和區隔。 使用下列篩選條件，只顯示在 FROM 子句中指定 user_list 時可使用的欄位。

查詢的 FROM 子句中是否指定了 user_list？

 資源欄位
id
名稱
resource_name
type
 區隔
date
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text

user_list.id
欄位說明使用者名單的 ID。
類別ATTRIBUTE
資料類型INT64
輸入網址N/A
是否可篩選是
可選取是
可排序是
重複否

user_list.name
欄位說明這份使用者名單的名稱。每個使用者名單都有專屬 ID，但如果使用者名單的名稱相同且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
資料類型
輸入網址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
資料類型
輸入網址google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType
是否可篩選是
可選取是
可排序是
重複否

segments.keyword.info.text
欄位說明關鍵字文字 (最多 80 個半形字元和 10 個字)。
類別SEGMENT
資料類型STRING
輸入網址N/A
是否可篩選是
可選取是
可排序是
重複否