Iterowatory to typowy wzorzec programowania używany do przeglądania listy obiektów, gdy
- Rozmiar listy może nie być znany od samego początku.
- Ładowanie całej listy do pamięci naraz może wymagać zbyt wielu zasobów.
Iteratory udostępniają 2 metody: boolean hasNext() i Object next().
Skrypty Google Ads używają wzorca Iterator do pobierania elementów Google Ads.
Pod względem funkcjonalności pętle nie różnią się zbytnio od zwykłych tablic i mogą pomóc w skrócie kodu. Porównaj kod, który przetwarza tablicę:
for (var i = 0; i < myArray.length; i++) {
let myObject = myArray[i];
}
z kodem, który przetwarza iterator:
while (myIterator.hasNext()) {
let myObject = myIterator.next();
}
Ten kod pokazuje, jak używać licznika w przypadku wszystkich kampanii na koncie:
var campaignIterator = AdsApp.campaigns().get();
while (campaignIterator.hasNext()) {
let campaign = campaignIterator.next();
console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
`budget=${campaign.getBudget().getAmount()}`);
}
Możesz też użyć wbudowanej iteracji JavaScript:
for (const campaign of AdsApp.campaigns()) {
console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
`budget=${campaign.getBudget().getAmount()}`);
}
Zastosowanie operatora withLimit() do selektora nie zmienia wartości totalNumEntities(). W następującym fragmencie kodu zmienne x i y będą miały tę samą wartość:
var x = AdsApp.keywords().get().totalNumEntities();
var y = AdsApp.keywords().withLimit(5).get().totalNumEntities();
Aby uzyskać Iterator obiektów Google Ads, musisz najpierw utworzyć Selector.