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	取得具有指定識別碼的排除字彙清單。
withLimit (int limit)	NegativeKeywordListSelector	取得符合選取準則的前 n 個 排除字彙清單。

取得

取得 反覆運算器 用來逐一查看排除字彙清單的清單。

傳回

類型	描述
NegativeKeywordListIterator	用來逐一查看排除字彙清單的反覆運算器。

orderBy (字串 orderBy)

將指定的順序套用至選取的排除字彙清單。

在 “columnName orderDirection” 表單中指定 orderBy 參數，其中：

• columnName 是支援的其中一個 資料欄位
• orderDirection 是要針對結果排序的順序。 設定為 ASC 以遞增順序排序結果，或設定為 DESC 以遞減順序排序結果。 預設值為 ASC。

例如，下列呼叫會依 MemberCount 遞增順序傳回排除字彙清單。

selector = selector.orderBy("MemberCount");

選取器僅支援依一個欄位來排序實體。 您不得依欄位 x、在 x 內依欄位 y 排序實體清單，依此類推。 如果您在鏈結或單獨的選擇器呼叫中指定多個 orderBy() 呼叫，則指令碼會使用上次 orderBy() 呼叫中指定的欄位對實體清單進行排序。 

引數

名稱	類型	描述
orderBy	字串	要申請的順序。

傳回

類型	描述
NegativeKeywordListSelector	已套用排序的選擇器。

withCondition (字串條件)

將篩選準則套用至排除字彙清單。

在「columnName operator value」表單中指定 條件 參數，其中：

• 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

支援的資料欄位。 欄名稱會區分大小寫。

欄位	類型	範例
MemberCount	int	清單中的排除字彙數目。 withCondition("MemberCount > 10")
名稱	字串	排除字彙清單的名稱。 withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount	int	與清單相關聯的廣告活動數目。 withCondition("ReferenceCount > 10")
SharedSetId	double	排除字彙清單的 ID。 如果您只是將其用於相等比較，請考慮改用該 withIds 方法。 withCondition("SharedSetId = 123456789")

引數

名稱	類型	描述
條件	字串	要新增至選取器的條件。

傳回

類型	描述
NegativeKeywordListSelector	具有套用條件的選擇器。

withIds (string[] ids)

取得具有指定識別碼的排除字彙清單。

您可以將一或多個條件套用至選取器。 條件鏈會被視為 AND 運算。 例如，只有在條件 A 為 True 且條件 B 為 True 時，才會選取實體。 例如，下列呼叫只會選取排除字彙清單 33333。

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

引數

名稱	類型	描述
IDS	string[]	排除字彙的陣列會列出識別碼。 如需限制，請參閱 指令碼執行限制。

傳回

類型	描述
NegativeKeywordListSelector	具有套用識別碼的選擇器。

withLimit (int limit)

取得符合選取準則的前 n 個 排除字彙清單。

引數

名稱	類型	描述
限制	int	要傳回的排除字彙清單數目。 實際數字可能會更少。

傳回

類型	描述
NegativeKeywordListSelector	已套用限制的選取器。

另請參閱

• NegativeKeywordListIterator
• NegativeKeywordList