Excluded Placement Lists
Stay organized with collections Save and categorize content based on your preferences.
Get all the placements in an excluded placement list
function getPlacementsFromExcludedPlacementList(name) { const excludedPlacementListIterator = AdsApp.excludedPlacementLists() .withCondition(`shared_set.name = '${name}'`) .get(); if (!excludedPlacementListIterator.hasNext()) { throw new Error(`No excluded placement list with name '${name}' found.`); } const excludedPlacementList = excludedPlacementListIterator.next(); return excludedPlacementList.excludedPlacements().get(); } Add a placement to an excluded placement list
function addPlacementToList(url, name) { const excludedPlacementListIterator = AdsApp.excludedPlacementLists() .withCondition(`shared_set.name = '${name}'`) .get(); if (!excludedPlacementListIterator.hasNext()) { throw new Error(`No excluded placement list with name '${name}' found.`); } const excludedPlacementList = excludedPlacementListIterator.next(); excludedPlacementList.addExcludedPlacement(url); } Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe provided code snippets demonstrate how to retrieve all placements within a specified excluded placement list using \u003ccode\u003egetPlacementsFromExcludedPlacementList\u003c/code\u003e function.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eaddPlacementToList\u003c/code\u003e function enables adding a new placement to an existing excluded placement list by utilizing its URL and list name.\u003c/p\u003e\n"],["\u003cp\u003eBoth functions utilize the \u003ccode\u003eAdsApp.excludedPlacementLists()\u003c/code\u003e method for accessing and manipulating excluded placement lists within Google Ads, throwing an error if the specified list name isn't found.\u003c/p\u003e\n"]]],[],null,["# Excluded Placement Lists\n\nGet all the placements in an excluded placement list\n----------------------------------------------------\n\n```gdscript\nfunction getPlacementsFromExcludedPlacementList(name) {\n const excludedPlacementListIterator =\n AdsApp.excludedPlacementLists()\n .withCondition(`shared_set.name = '${name}'`)\n .get();\n\n if (!excludedPlacementListIterator.hasNext()) {\n throw new Error(`No excluded placement list with name '${name}' found.`);\n }\n\n const excludedPlacementList = excludedPlacementListIterator.next();\n return excludedPlacementList.excludedPlacements().get();\n}\n```\n\nAdd a placement to an excluded placement list\n---------------------------------------------\n\n```gdscript\nfunction addPlacementToList(url, name) {\n const excludedPlacementListIterator =\n AdsApp.excludedPlacementLists()\n .withCondition(`shared_set.name = '${name}'`)\n .get();\n\n if (!excludedPlacementListIterator.hasNext()) {\n throw new Error(`No excluded placement list with name '${name}' found.`);\n }\n const excludedPlacementList = excludedPlacementListIterator.next();\n excludedPlacementList.addExcludedPlacement(url);\n}\n```"]]
