Que sont les itérateurs ?

Les itérateurs énumèrent les éléments qu’un sélecteur renvoie. Les itérateurs sont similaires aux tableaux, sauf que vous ne pouvez pas utiliser un index pour accéder directement à un élément. Les itérateurs aident également à réduire la sollicitation de la mémoire en chargeant un seul élément à la fois plutôt que l’ensemble complet des éléments. Les itérateurs incluent les méthodes suivantes.

• boolean hasNext() — Retourne true si la position actuelle n’est pas le dernier élément de la liste
• Object next() — Avance la position actuelle et renvoie 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
• AssetGroupIterator
• AdIterator
• AdParamIterator
• BingAdsAccountIterator
• BudgetIterator
• CampaignIterator
• ExcludedLocationIterator
• KeywordIterator
• NegativeKeywordListIterator
• ProductGroupIterator
• TargetedLocationIterator

Étapes suivantes

En savoir plus sur les constructeurs