Итераторы

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

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

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

Функционально итераторы не слишком отличаются от обычных массивов и могут сделать ваш код более лаконичным. Сравните код, который обходит массив:

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 Ads необходимо сначала создать селектор .