选择器

选择器可帮助编程人员构建用于抓取目标 AdWords 实体的查询。通过使用选择器,编程人员可以精简实体检索结果列表,并为其排序。大多数选择器提供以下方法:

withCondition()
向选择器添加条件。如果使用多个条件,这些条件将以 AND 关系结合在一起。也就是说,选择器只会返回满足所有指定条件的实体。
withIds()
添加一组 ID 作为一个条件。基于 ID 的条件将与其他所有条件以 AND 关系结合在一起。
forDateRange()
当条件或排序子句引用统计信息字段(如“点击率”或“展示次数”)时需要此方法。如果您请求展示次数超过 100 次的所有广告系列,AdWords 脚本需要知道要查找的日期范围。
orderBy()
指定返回实体的排序。
withLimit()
将返回实体的数量限制为特定值。当与 orderBy() 配合使用以抓取“昨天获得展示次数最多的 10 个关键字”之类的数据时非常有用。

可按照任意顺序调用这些方法。唯一的例外是 orderBy(),其调用顺序非常重要:对此方法的多次调用将指定多个排序子句,并且这些子句将按顺序应用。请考虑下列代码段:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("Clicks DESC")
    .orderBy("CTR ASC");

结果按“点击次数”降序排列,“点击次数”值相同的结果将会按“点击率”升序排列。

对选择器方法的调用可串连在一起。以下代码

var campaignSelector = AdWordsApp.campaigns();
campaignSelector.withCondition("Clicks > 10");
campaignSelector.withCondition("Impressions > 1000");
campaignSelector.orderBy("Impressions DESC");
campaignSelector.forDateRange("YESTERDAY");

可以按照更紧凑的方式重写:

var campaignSelector = AdWordsApp.campaigns()
  .withCondition("Clicks > 10")
  .withCondition("Impressions > 1000")
  .orderBy("Impressions DESC")
  .forDateRange("YESTERDAY");

构建了选择器之后,编程人员可以调用 selector.get() 来从中获取迭代器

有些选择器(如 AdParamSelectorLabelSelector)公开的方法较少,因为它们需要在限制较多(没有可作为排序依据的统计信息字段或有意义的字段)的实体上运行。

请参阅最佳做法,获取关于高效使用选择器的提示和技巧。

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面