Iteradores

Los iteradores son un patrón de programación común que se usa para recorrer una lista de objetos cuando ocurre lo siguiente:

• Es posible que no se conozca el tamaño de la lista desde el principio.
• Cargar toda la lista en la memoria a la vez puede resultar demasiado exigente en cuanto a los recursos.

Los iteradores exponen dos métodos: boolean hasNext() y Object next(). Las secuencias de comandos de Google Ads usan el patrón de iterador para recuperar entidades de Google Ads.

En cuanto a la funcionalidad, los iteradores no son muy diferentes de los arrays normales y pueden hacer que tu código sea más conciso. Compara el código que recorre un array:

for (var i = 0; i < myArray.length; i++) {
  let myObject = myArray[i];
}

con el código que recorre un iterador:

while (myIterator.hasNext()) {
  let myObject = myIterator.next();
}

En el siguiente código, se muestra el uso de un iterador en todas las campañas de Búsqueda y Display de tu cuenta:

var campaignIterator = AdsApp.campaigns().get();

while (campaignIterator.hasNext()) {
  let campaign = campaignIterator.next();
  console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
      `budget=${campaign.getBudget().getAmount()}`);
}

También puedes usar la iteración integrada de JavaScript:

for (const campaign of AdsApp.campaigns()) {
  console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
      `budget=${campaign.getBudget().getAmount()}`);
}

La aplicación de withLimit() a un selector no cambia el valor de totalNumEntities(). x y y en el siguiente fragmento tendrán el mismo valor:

var x = AdsApp.keywords().get().totalNumEntities();
var y = AdsApp.keywords().withLimit(5).get().totalNumEntities();

Para obtener un iterador de entidades de Google Ads, primero debes crear un selector.