Итераторы — это распространенный шаблон программирования, используемый для обхода списка объектов, когда
- Размер списка может быть неизвестен с самого начала.
- Одновременная загрузка всего списка в память может оказаться слишком ресурсоемкой.
Итераторы предоставляют два метода: boolean hasNext() и Object next() . Скрипты Google Ads используют шаблон Iterator для извлечения сущностей 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, необходимо сначала создать селектор .