反復子は 、セレクター が返す項目を列挙します。 反復子は配列に似ていますが、インデックスを使用して項目に直接アクセスすることはできません。 また、イテレーターを使用すると、アイテムのセット全体ではなく 一度に 1 つのアイテムのみを読み込むことで、メモリ負荷を軽減することもできます。 イテレータには以下のメソッドが含まれます。
- boolean hasNext() — 現在の位置がリストの最後のアイテムではない場合に true を返します
- Object next() — 現在の位置に進み、新しい位置にオブジェクトを戻します
- totalNumEntities() — 反復子で使用可能な項目の数を返します。
次のコードは、イテレータを使用してアカウント内のすべての広告グループを反復処理する方法を示しています。
var iterator = AdsApp.adGroups().get();
while (iterator.hasNext()) {
var adGroup = iterator.next();
}
注:
反復子は for-of ループ構造をサポートしていません。 例:
for (var campaign of AdsApp.campaigns().get())
反復子の一覧を次に示します。
- AdGroupIterator
- AssetGroupIterator
- AdIterator
- AdParamIterator
- BingAdsAccountIterator
- BudgetIterator
- CampaignIterator
- ExcludedLocationIterator
- KeywordIterator
- NegativeKeywordListIterator
- ProductGroupIterator
- TargetedLocationIterator