المكرّرات

المكرّرات هي نمط برمجة شائع يُستخدَم لتصفّح قائمة من العناصر عندما

  • قد لا يكون حجم القائمة معروفًا من البداية.
  • قد يكون تحميل القائمة بأكملها في الذاكرة في وقت واحد عملية مكلفة للغاية من حيث الموارد.

تعرض المكرّرات طريقتَين: boolean hasNext() وObject next(). تستخدِم نصوص "إعلانات Google" البرمجية نمط Iterator لجلب عناصر "إعلانات Google".

من الناحية الوظيفية، لا تختلف المكرّرات كثيرًا عن المصفوفات العادية، ويمكن أن تجعل الرمز البرمجي أكثر إيجازًا. قارِن الرمز الذي يتنقّل بين عناصر مصفوفة:

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

باستخدام رمز يتنقّل بين عناصر مكرّر:

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

يوضّح الرمز التالي كيفية استخدام أداة تكرار على جميع &quot;الحملات على شبكة البحث&quot; و&quot;الحملات على الشبكة الإعلانية&quot; في حسابك:

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"، يجب إنشاء أداة اختيار أولاً.