Yineleyiciler, bir nesne listesinde gezinmek için kullanılan yaygın bir programlama modelidir.
- Listenin boyutu başlangıçta bilinmeyebilir.
- Listenin tamamını tek seferde belleğe yüklemek, kaynakları aşırı derecede tüketebilir.
Yineleyiciler iki yöntem sunar: boolean hasNext() ve Object next().
Google Ads komut dosyaları, Google Ads öğelerini getirmek için yineleyici kalıbını kullanır.
İşlevsel olarak yineleyiciler normal dizilerden çok farklı değildir ve kodunuzu daha kısa hale getirebilir. Bir dizide dolaşan kodu karşılaştırın:
for (var i = 0; i < myArray.length; i++) {
let myObject = myArray[i];
}
bir iteratörde gezinen kodla:
while (myIterator.hasNext()) {
let myObject = myIterator.next();
}
Aşağıdaki kod, hesabınızdaki tüm Arama Ağı ve Görüntülü Reklam Ağı kampanyalarında bir yineleyicinin kullanımını göstermektedir:
var campaignIterator = AdsApp.campaigns().get();
while (campaignIterator.hasNext()) {
let campaign = campaignIterator.next();
console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
`budget=${campaign.getBudget().getAmount()}`);
}
Yerleşik JavaScript iterasyonunu da kullanabilirsiniz:
for (const campaign of AdsApp.campaigns()) {
console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
`budget=${campaign.getBudget().getAmount()}`);
}
withLimit() seçiciye uygulandığında totalNumEntities() değeri değişmez. Aşağıdaki snippet'te x ve y aynı değere sahip olacaktır:
var x = AdsApp.keywords().get().totalNumEntities();
var y = AdsApp.keywords().withLimit(5).get().totalNumEntities();
Google Ads varlıklarının yineleyicisini elde etmek için önce bir seçici oluşturmanız gerekir.