تکرارگرها

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

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

تکرارگرها دو روش را آشکار می‌کنند: 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()}`);
}

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

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، ابتدا باید یک Selector بسازید.