AdsApp.NegativeKeywordListIterator
Stay organized with collections
Save and categorize content based on your preferences.
An iterator of negative keyword lists.
Typical usage:
while (negativeKeywordListIterator.hasNext()) {
var negativeKeywordList = negativeKeywordListIterator.next();
}
Related:
Methods:
hasNext()
Returns
true
if the iterator has more elements.
Return values:
Type | Description |
boolean |
true if the iterator has more elements. |
next()
Returns the next
NegativeKeywordList in the iterator.
Return values:
totalNumEntities()
Returns the total number of entities matched by the selector which
generated this iterator.
Note that the returned number disregards limits, and that the iterator
is not guaranteed to have this many elements — hasNext
will
start to return false
and next
will start to
throw exceptions as soon as the limit for entity reads has been reached,
even if the selector matched more entities.
Return values:
Type | Description |
int |
The number of entities matched by the selector which generated this
iterator. |
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-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis iterator allows you to process a collection of negative keyword lists within your Google Ads scripts.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003ehasNext()\u003c/code\u003e to check for more negative keyword lists and \u003ccode\u003enext()\u003c/code\u003e to retrieve the next list in the sequence.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the total number of negative keyword lists matched by the selector via \u003ccode\u003etotalNumEntities()\u003c/code\u003e, though this number may exceed the actual iterable items due to limitations.\u003c/p\u003e\n"],["\u003cp\u003eRelated resources include \u003ccode\u003eNegativeKeywordListSelector\u003c/code\u003e for list selection and \u003ccode\u003eNegativeKeywordList\u003c/code\u003e for details on individual list objects.\u003c/p\u003e\n"]]],[],null,["# AdsApp.NegativeKeywordListIterator\n\nAn iterator of negative keyword lists.\n\nTypical usage:\n\n```gdscript\nwhile (negativeKeywordListIterator.hasNext()) {\n var negativeKeywordList = negativeKeywordListIterator.next();\n}\n```\nRelated:\n\n- [NegativeKeywordListSelector.get()](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlistselector#get)\n- [NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist)\n\n### Methods:\n\n| Member | Type | Description |\n|-----------------------------------------|----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|\n| [hasNext()](#hasNext) | `boolean` | Returns `true` if the iterator has more elements. |\n| [next()](#next) | [AdsApp.NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist) | Returns the next [NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist) in the iterator. |\n| [totalNumEntities()](#totalNumEntities) | `int` | Returns the total number of entities matched by the selector which generated this iterator. |\n\n`hasNext()`\n-----------\n\nReturns `true` if the iterator has more elements.\n\n### Return values:\n\n| Type | Description |\n|-----------|-------------------------------------------|\n| `boolean` | `true` if the iterator has more elements. |\n\n`next()`\n--------\n\nReturns the next [NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist) in the iterator.\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|\n| [AdsApp.NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist) | The next [NegativeKeywordList](/google-ads/scripts/docs/reference/adsapp/adsapp_negativekeywordlist) in the iterator. |\n\n`totalNumEntities()`\n--------------------\n\nReturns the total number of entities matched by the selector which generated this iterator.\n\nNote that the returned number disregards limits, and that the iterator\nis not guaranteed to have this many elements --- `hasNext` will\nstart to return `false` and `next` will start to\nthrow exceptions as soon as the limit for entity reads has been reached,\neven if the selector matched more entities.\n\n### Return values:\n\n| Type | Description |\n|-------|-------------------------------------------------------------------------------|\n| `int` | The number of entities matched by the selector which generated this iterator. |"]]