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```"]]
