AdsApp.​VideoTopicIterator

  • VideoTopicIterator allows you to iterate through a collection of VideoTopics, which represent categories or themes of YouTube videos.

  • You can use hasNext() to check for more VideoTopics and next() to retrieve the next VideoTopic in the iteration.

  • totalNumEntities() provides the total count of VideoTopics matched by the selector, although the actual number of iterable items might be limited.

  • VideoTopicIterator is related to VideoTopicSelector, used to select VideoTopics based on specific criteria, and VideoTopic, which represents a specific video topic.

 An iterator of video topics.

Typical usage: 

while (topicIterator.hasNext()) {
  var topic = topicIterator.next();
}
 Related:

Methods:

MemberTypeDescription
hasNext() boolean Returns true if the iterator has more elements.
next() AdsApp.VideoTopic Returns the next VideoTopic in the iterator.
totalNumEntities() int Returns the total number of entities matched by the selector which generated this iterator.

hasNext()

Returns true if the iterator has more elements.

Return values:

TypeDescription
boolean true if the iterator has more elements.

next()

Returns the next VideoTopic in the iterator.

Return values:

TypeDescription
AdsApp.VideoTopic The next VideoTopic in the iterator.

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:

TypeDescription
int The number of entities matched by the selector which generated this iterator.