疊代器是一種常見的程式設計模式,可在下列情況中掃遍物件清單:
- 無法一開始就知道清單大小。
- 一次將整份清單載入記憶體,可能會導致過度耗用資源。
疊代器公開了兩個方法: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 實體的疊代器。