O que são iteradores?
Os iteradores enumeram os itens devolvidos por um seletor . Os iteradores são semelhantes às matrizes, exceto que não pode utilizar um índice para aceder diretamente a um item. Os iteradores também ajudam a reduzir a pressão da memória ao carregar apenas um único item de cada vez em vez de todo o conjunto de itens. Os iteradores incluem os seguintes métodos.
- booleano hasNext() — Devolve verdadeiro se a posição atual não for o último item na lista
- Objeto seguinte() — Avança a posição atual e devolve o objeto na nova posição
- totalNumEntities() — Devolve o número de itens disponíveis no iterador.
O código seguinte mostra como utilizar um iterador para iterar todos os grupos de anúncios na sua conta.
var iterator = AdsApp.adGroups().get();
while (iterator.hasNext()) {
var adGroup = iterator.next();
}
Nota
Os iteradores não suportam a construção for-of-loop . Por exemplo:
for (var campaign of AdsApp.campaigns().get())
Segue-se a lista de iteradores.
- AdGroupIterator
- AdIterator
- AdParamIterator
- BingAdsAccountIterator
- BudgetIterator
- CampaignIterator
- ExcludedLocationIterator
- KeywordIterator
- NegativeKeywordListIterator
- ProductGroupIterator
- TargetedLocationIterator