NegativeKeywordListSelector

包含用于筛选和排序否定关键字列表的方法。 有关选择器的信息，请参阅 选择器。

用法示例：

    var iterator = AdsApp.negativeKeywordLists()
        .withCondition("MemberCount > 10")
        .orderBy("Name")
        .get();

    while (iterator.hasNext()) {
        var nkwList = iterator.next();
    }

方法

方法名称	返回类型	说明
get	NegativeKeywordListIterator	获取用于循环访问否定关键字列表的迭代器。
orderBy (字符串 orderBy)	NegativeKeywordListSelector	将指定的排序应用于所选的负关键字列表。
withCondition (字符串条件)	NegativeKeywordListSelector	将筛选条件应用于否定关键字列表。
withIds (string[] ids)	NegativeKeywordListSelector	获取具有指定 ID 的否定关键字列表。
withLimit (int limit)	NegativeKeywordListSelector	获取与选择条件匹配的前 n 个 负关键字列表。

获取

获取 迭代器 用于循环访问否定关键字列表的列表。

返回

类型	说明
NegativeKeywordListIterator	用于循环访问负关键字列表的迭代器。

orderBy (string orderBy)

将指定的排序应用于所选的负关键字列表。

在“columnName orderDirection”窗体中指定 orderBy 参数，其中：

• columnName 是受支持的列之一
• orderDirection 是对结果进行排序的顺序。 设置为 ASC 可按升序对结果进行排序，或设置为 DESC 以按降序对结果进行排序。 默认值为 ASC。

例如，以下调用按 MemberCount 按升序返回否定关键字列表。

selector = selector.orderBy("MemberCount");

选择器仅支持按一个字段对实体进行排序。 不能按字段 x 对实体列表进行排序，在 x 中按字段 y 排序，等等。 如果在链或单独的选择器调用中指定多个 orderBy() 调用，则脚本将使用上次 orderBy() 调用中指定的字段对实体列表进行排序。 

参数

名称	类型	说明
orderBy	string	要应用的排序。

返回

类型	说明
NegativeKeywordListSelector	应用了排序的选择器。

withCondition (字符串条件)

将筛选条件应用于否定关键字列表。

以“columnName 运算符值”的形式指定 条件 参数，其中：

• columnName 是 受支持的列之一。
• 运算符 是受支持的 运算符之一。

运算符

使用的运算符取决于列的类型。 运算符区分大小写。 例如，使用 STARTS_WITH 而不是 starts_with。

包含整数和长值的列的运算符：

<
<=
>
>=
=
!=

包含双精度值的列的运算符：

<
>

包含字符串值的列的运算符：

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

包含枚举值的列的运算符：

=
!=
IN []
NOT_IN []

包含字符串数组的列的运算符：

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

支持的列。 列名称需区分大小写。

Column	类型	示例
MemberCount	int	列表中的负关键字数。 withCondition("MemberCount > 10")
名称	string	负关键字 (keyword) 列表的名称。 withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount	int	与列表关联的市场活动数。 withCondition("ReferenceCount > 10")
SharedSetId	double	负关键字 (keyword) 列表的 ID。 如果只是使用它进行相等比较，请考虑改用 withIds 方法。 withCondition("SharedSetId = 123456789")

参数

名称	类型	说明
条件	string	要添加到选择器的条件。

返回

类型	说明
NegativeKeywordListSelector	应用了条件的选择器。

withIds (string[] ids)

获取具有指定 ID 的否定关键字列表。

可以将一个或多个条件应用于选择器。 条件链被视为 AND 操作。 例如，仅当条件 A 为 true 且条件 B 为 true 时，才会选择实体。 例如，以下调用仅选择否定关键字列表 33333。

AdsApp.negativeKeywordLists()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

参数

名称	类型	说明
ids	string[]	负关键字 (keyword) 列表 ID 的数组。 有关限制，请参阅 脚本执行限制。

返回

类型	说明
NegativeKeywordListSelector	应用了 ID 的选择器。

withLimit (int 限制)

获取与选择条件匹配的前 n 个 负关键字列表。

参数

名称	类型	说明
limit	int	要返回的负关键字列表数。 实际数字可能更少。

返回

类型	说明
NegativeKeywordListSelector	应用了限制的选择器。

另请参阅

• NegativeKeywordListIterator
• NegativeKeywordList