API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
user_list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Danh sách người dùng. Đây là danh sách người dùng mà khách hàng có thể nhắm đến. Khoá duy nhất của danh sách người dùng bao gồm các trường sau: id. Xin lưu ý rằng name cũng phải là giá trị duy nhất cho danh sách người dùng thuộc sở hữu của một khách hàng nhất định, ngoại trừ một số trường hợp access_reason được đặt thành SHARED. Vi phạm quy định giới hạn về tên riêng biệt sẽ gây ra lỗi: UserListError.INVALID_NAME.
Bạn có thể chọn các trường từ các tài nguyên ở trên cùng với tài nguyên này trong mệnh đề SELECT và WHERE. Những trường này sẽ không phân đoạn các chỉ số trong mệnh đề SELECT của bạn.
Trường/Phân đoạn/Chỉ số
Trang này cho biết tất cả các chỉ số và phân đoạn có thể được đưa vào cùng một mệnh đề SELECT với các trường của user_list.
Tuy nhiên, khi bạn chỉ định user_list trong mệnh đề FROM, bạn không thể sử dụng một số chỉ số và phân khúc.
Sử dụng bộ lọc sau đây để chỉ cho thấy những trường có thể dùng khi user_list được chỉ định trong mệnh đề FROM.
user_list có được chỉ định trong mệnh đề FROM của truy vấn không?
Tên của danh sách người dùng này. Riêng biệt cho mỗi danh sách người dùng, ngoại trừ một số trường hợp danh sách người dùng có cùng tên được đặt access_reason thành SHARED.
Danh mục
ATTRIBUTE
Loại dữ liệu
STRING
Nhập URL
N/A
Có thể lọc
Đúng
Có thể chọn
Đúng
Sortable
Đúng
Lặp lại
Sai
user_list.resource_name
Phần mô tả về trường
Tên tài nguyên của danh sách người dùng. Tên tài nguyên danh sách người dùng có dạng: customers/{customer_id}/userLists/{user_list_id}
[null,null,["Cập nhật lần gần đây nhất: 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"]]
