Danh sách người dùng
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.
Truy lục tất cả danh sách người dùng
function getAllUserLists() {
const userLists = AdsApp.userlists().get();
console.log(`${userLists.totalNumEntities()} user lists found.`);
return userLists;
}
Ghi nhật ký số lượng thành viên trong mỗi danh sách người dùng
function logUserListMemberCount() {
const userlists = AdsApp.userlists().get();
for (const userlist of userlists) {
console.log(`${userlist.getName()} has ${userlist.getSizeForSearch()} `
+ `members for Search campaigns and ${userlist.getSizeForDisplay()} `
+ `members for Display campaigns.`);
}
}
Mở danh sách người dùng
function openUserList(name) {
const userlists = AdsApp.userlists()
.withCondition(`user_list.name = '${name}'`)
.get();
if (userlists.totalNumEntities() == 0) {
throw new Error(`No user list with name '${name}' found.`);
}
const userlist = userlists.next();
userlist.open();
}
Truy lục chiến dịch tìm kiếm được nhắm mục tiêu theo danh sách người dùng
function getSearchCampaignsTargetedByUserList(name) {
const userlists = AdsApp.userlists()
.withCondition(`user_list.name = '${name}'`)
.get();
if (userlists.totalNumEntities() == 0) {
throw new Error(`No user list with name '${name}' found.`);
}
const userlist = userlists.next();
const campaigns = userlist.targetedCampaigns().get();
console.log(`Userlist '${name}' is targeting ${campaigns.totalNumEntities()} campaigns.`);
return campaigns;
}
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[[["\u003cp\u003eThe provided Google Ads scripts demonstrate how to retrieve, examine, and manage user lists within your account.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve all user lists and their member counts (separately for Search and Display campaigns) using these scripts.\u003c/p\u003e\n"],["\u003cp\u003eThe scripts also enable opening a specific user list by name and identifying the search campaigns it targets.\u003c/p\u003e\n"],["\u003cp\u003eIf no user list with the specified name exists, the script throws an error to indicate this.\u003c/p\u003e\n"]]],[],null,["# User Lists\n\nRetrieve all user lists\n-----------------------\n\n```gdscript\nfunction getAllUserLists() {\n const userLists = AdsApp.userlists().get();\n console.log(`${userLists.totalNumEntities()} user lists found.`);\n return userLists;\n}\n```\n\nLog the number of members in each user list\n-------------------------------------------\n\n```perl6\nfunction logUserListMemberCount() {\n const userlists = AdsApp.userlists().get();\n for (const userlist of userlists) {\n console.log(`${userlist.getName()} has ${userlist.getSizeForSearch()} `\n + `members for Search campaigns and ${userlist.getSizeForDisplay()} `\n + `members for Display campaigns.`);\n }\n}\n```\n\nOpen a user list\n----------------\n\n```gdscript\nfunction openUserList(name) {\n const userlists = AdsApp.userlists()\n .withCondition(`user_list.name = '${name}'`)\n .get();\n if (userlists.totalNumEntities() == 0) {\n throw new Error(`No user list with name '${name}' found.`);\n }\n const userlist = userlists.next();\n userlist.open();\n}\n```\n\nRetrieve search campaigns targeted by a user list\n-------------------------------------------------\n\n```gdscript\nfunction getSearchCampaignsTargetedByUserList(name) {\n const userlists = AdsApp.userlists()\n .withCondition(`user_list.name = '${name}'`)\n .get();\n if (userlists.totalNumEntities() == 0) {\n throw new Error(`No user list with name '${name}' found.`);\n }\n const userlist = userlists.next();\n const campaigns = userlist.targetedCampaigns().get();\n console.log(`Userlist '${name}' is targeting ${campaigns.totalNumEntities()} campaigns.`);\n return campaigns;\n}\n```"]]