Que sont les itérateurs ?
Les itérateurs énumèrent les éléments retournés par un sélecteur . Les itérateurs sont similaires aux tableaux, sauf que vous ne pouvez pas utiliser d’index pour accéder directement à un élément. Les itérateurs permettent également de réduire la sollicitation de la mémoire en ne chargeant qu’un seul élément à la fois plutôt que l’ensemble des éléments. Les itérateurs incluent les méthodes suivantes.
- boolean hasNext() : renvoie true si la position actuelle n’est pas le dernier élément de la liste
- Object next() : avance la position actuelle et retourne l’objet à la nouvelle position
- totalNumEntities() : renvoie le nombre d’éléments disponibles dans l’itérateur.
Le code suivant montre comment utiliser un itérateur pour itérer sur tous les groupes d’annonces de votre compte.
var iterator = AdsApp.adGroups().get();
while (iterator.hasNext()) {
var adGroup = iterator.next();
}
Remarque
Les itérateurs ne prennent pas en charge la construction de boucle for-of . Par exemple :
for (var campaign of AdsApp.campaigns().get())
Voici la liste des itérateurs.
- AdGroupIterator
- AdIterator
- AdParamIterator
- BingAdsAccountIterator
- BudgetIterator
- CampaignIterator
- ExcludedLocationIterator
- KeywordIterator
- NegativeKeywordListIterator
- ProductGroupIterator
- TargetedLocationIterator