Los iteradores son un patrón de programación común que se usa para recorrer una lista de objetos cuando
- Es posible que el tamaño de la lista no se conozca desde el principio.
- Cargar toda la lista en la memoria a la vez puede generar un uso excesivo de recursos.
Los iteradores exponen dos métodos: boolean hasNext()
y Object next()
.
Las secuencias de comandos de Google Ads utilizan el patrón 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 desvía un array:
for (var i = 0; i < myArray.length; i++) {
let myObject = myArray[i];
}
con código que desvía un iterador:
while (myIterator.hasNext()) {
let myObject = myIterator.next();
}
El siguiente código muestra el uso de un iterador en todas las campañas 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 de JavaScript incorporada:
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
del 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.