Iterator เป็นรูปแบบการเขียนโปรแกรมทั่วไปที่ใช้สำหรับข้ามผ่านรายการออบเจ็กต์เมื่อ
- ระบบอาจไม่ทราบขนาดของรายการตั้งแต่เริ่มต้น
- การโหลดรายการทั้งหมดลงในหน่วยความจำพร้อมกันอาจเป็นการใช้ทรัพยากรมากเกินไป
ตัววนซ้ำแสดง 2 วิธี ได้แก่ 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();
ในการรับ Iterator ของเอนทิตี Google Ads คุณต้องสร้างตัวเลือกก่อน