迭代器

迭代器是一种常见的编程模式，用于在以下情况下遍历对象列表：

  • 一开始可能并不知道列表的大小。
  • 一次将整个列表加载到内存中可能会导致资源消耗过多。

迭代器公开了两种方法：boolean hasNext() 和 Object next()。Google Ads 脚本使用迭代器模式提取 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()}`);
}

您还可以使用内置的 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();

如需获取 Google Ads 实体的迭代器，您必须先构建一个选择器。