Listas de usuários
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Recuperar todas as listas de usuários
function getAllUserLists() { const userLists = AdsApp.userlists().get(); console.log(`${userLists.totalNumEntities()} user lists found.`); return userLists; }
Registrar o número de membros em cada lista de usuários
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.`); } }
Abrir uma lista de usuários
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(); }
Recuperar campanhas da rede de pesquisa segmentadas por uma lista de usuários
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; }
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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```"]]