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.
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 duy nhấ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.
user_list.id
Phần mô tả về trường
Mã nhận dạng của danh sách người dùng.
Danh mục
ATTRIBUTE
Loại dữ liệu
INT64
Nhập URL
N/A
Có thể lọc
Đúng
Có thể chọn
Đúng
Sortable
Đúng
Lặp lại
Sai
user_list.name
Phần mô tả về trườ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-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"]]