โปรแกรมซ้ํา

Iterator เป็นรูปแบบการเขียนโปรแกรมทั่วไปที่ใช้ในการข้ามผ่านรายการออบเจ็กต์เมื่อ

• คุณอาจไม่ทราบขนาดของรายการตั้งแต่เริ่มต้น
• การโหลดทั้งรายการลงในหน่วยความจำพร้อมกันอาจใช้ทรัพยากรมากเกินไป

Iterator มี 2 เมธอด ได้แก่ boolean hasNext() และ Object next() สคริปต์ Google Ads ใช้รูปแบบ Iterator เพื่อดึงข้อมูลเอนทิตี Google Ads

ในส่วนของการใช้งาน Iterator ไม่ได้แตกต่างจากอาร์เรย์ปกติมากนัก และยังช่วยให้โค้ดกระชับขึ้นด้วย ลองเปรียบเทียบโค้ดที่ข้ามผ่านอาร์เรย์

for (var i = 0; i < myArray.length; i++) {
  let myObject = myArray[i];
}

กับโค้ดที่ข้ามผ่าน Iterator

while (myIterator.hasNext()) {
  let myObject = myIterator.next();
}

โค้ดต่อไปนี้แสดงการใช้งาน Iterator กับแคมเปญ Search และแคมเปญ Display ทั้งหมดในบัญชี

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 คุณต้องสร้าง ตัวเลือกก่อน