Daftar Pengguna
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Ambil semua daftar pengguna
function getAllUserLists() {
const userLists = AdsApp.userlists().get();
console.log(`${userLists.totalNumEntities()} user lists found.`);
return userLists;
}
Catat jumlah anggota di setiap daftar pengguna
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.`);
}
}
Buka daftar pengguna
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();
}
Ambil kampanye penelusuran yang ditargetkan oleh daftar pengguna
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;
}
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 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```"]]