사용자 목록
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
모든 사용자 목록 검색
function getAllUserLists() {
const userLists = AdsApp.userlists().get();
console.log(`${userLists.totalNumEntities()} user lists found.`);
return userLists;
}
각 사용자 목록의 회원 수를 기록합니다.
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.`);
}
}
사용자 목록 열기
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();
}
사용자 목록으로 타겟팅된 검색 캠페인 검색
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;
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 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```"]]