Итераторы

Итераторы – это распространенный шаблон программирования, используемый для обхода списка объектов, когда

• Размер списка изначально не известен.
• Загрузка всего списка в память за один раз может потребовать слишком много ресурсов.

Итераторы поддерживают два метода: boolean hasNext() и Object next(). Скрипты Google Рекламы используют шаблон Iterator для получения объектов Google Рекламы.

Функционально итераторы мало чем отличаются от обычных массивов и позволяют сделать код более лаконичным. Приведем в качестве примера код для сбора данных из массива:

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

Код для итератора:

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

В следующем примере кода показано, как использовать итератор для всех кампаний в поисковой и контекстно-медийной сетях в вашем аккаунте:

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

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

Также можно использовать встроенную итерацию JavaScript:

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

Применение withLimit() к селектору не меняет значение totalNumEntities(). x и y в приведенном ниже фрагменте будут иметь одинаковое значение:

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

Чтобы получить итератор объектов Google Рекламы, сначала нужно создать селектор.