iteratory,

Iteratory to powszechny wzorzec programowania używany do przechodzenia po liście obiektów, gdy

• Rozmiar listy może nie być znany od początku.
• Wczytywanie całej listy do pamięci naraz może być zbyt zasobochłonne.

Iteratory udostępniają 2 metody: boolean hasNext() i Object next(). Skrypty Google Ads używają wzorca iteratora do pobierania elementów Google Ads.

Pod względem funkcjonalności iteratory nie różnią się zbytnio od zwykłych tablic i mogą sprawić, że kod będzie bardziej zwięzły. Porównaj kod, który przechodzi przez tablicę:

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

z kodem, który przechodzi przez iterator:

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

Poniższy kod pokazuje, jak używać iteratora w przypadku wszystkich kampanii w sieci wyszukiwania i reklamowej na Twoim 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 JavaScriptu:

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

Zastosowanie withLimit() do selektora nie zmienia wartości totalNumEntities(). W poniższym 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ć selektor.