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

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

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

تکرار کننده ها دو روش را نشان می دهند: 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 بسازید.