تکرار کننده ها

تکرارکننده‌ها یک الگوی برنامه‌نویسی رایج هستند که برای پیمایش لیستی از اشیاء استفاده می‌شوند.

• ممکن است اندازه لیست از ابتدا مشخص نباشد.
• بارگذاری کل لیست به طور همزمان در حافظه ممکن است بیش از حد منابع را فشرده کند.

تکرارکننده‌ها دو متد ارائه می‌دهند: boolean hasNext() و Object next() . اسکریپت‌های گوگل ادز از الگوی تکرارکننده برای دریافت موجودیت‌های گوگل ادز استفاده می‌کنند.

از نظر عملکردی، تکرارکننده‌ها تفاوت چندانی با آرایه‌های معمولی ندارند و می‌توانند کد شما را مختصرتر کنند. کدی را که یک آرایه را پیمایش می‌کند، مقایسه کنید:

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

با کدی که یک تکرارکننده را پیمایش می‌کند:

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

کد زیر نحوه‌ی استفاده از یک iterator را در تمام کمپین‌های جستجو و نمایش در حساب شما نشان می‌دهد:

var campaignIterator = AdsApp.campaigns().get();

while (campaignIterator.hasNext()) {
  let campaign = campaignIterator.next();
  console.log(`${campaign.getName()}; active? ${campaign.isEnabled()}; ` +
      `budget=${campaign.getBudget().getAmount()}`);
}

همچنین می‌توانید از تکرار داخلی جاوا اسکریپت استفاده کنید:

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 از موجودیت‌های گوگل ادز، ابتدا باید یک Selector بسازید.