迭代器

疊代器是常見的程式設計模式，用於在下列情況中遍歷物件清單：

• 無法一開始就知道清單大小。
• 一次將整個清單載入記憶體，可能會耗用過多資源。

疊代器會公開兩種方法：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 實體的疊代器，請先建構 Selector。