共用方式為

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 限制) NegativeKeywordListSelector 取得符合選取準則的前 n 個負數關鍵字清單。

獲取

取得 反覆運算器 ，用來逐一查看負關鍵字清單的清單。

傳回

類型 說明
NegativeKeywordListIterator 用來逐一查看負關鍵字清單的反覆運算器。

orderBy (字串 orderBy)

將指定的順序套用至選取的負關鍵字清單。

以 「columnName orderDirection」 格式指定 orderBy 參數，其中：

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

例如，下列呼叫會依 MemberCount 以遞增順序傳回負關鍵字清單。

selector = selector.orderBy("MemberCount");

選取器僅支援依一個欄位排序實體。 您不能依欄位 x 排序實體清單，也無法依欄位 y 排序 x 中的實體清單，依此類推。 如果您在鏈結或個別選取器呼叫中指定多個呼叫，則腳本會使用上 orderBy() 一個 orderBy() 呼叫中指定的欄位來排序實體清單。 

引數

名稱 類型 說明
orderBy 字串 要套用的順序。

傳回

類型 說明
NegativeKeywordListSelector 已套用排序的選取器。

withCondition (字串條件)

將篩選準則套用至負關鍵字清單。

指定 「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 負關鍵字清單的識別碼。 如果您只要將此專案用於相等比較，請考慮改用 withIds 方法。

withCondition("SharedSetId = 123456789")

引數

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

傳回

類型 說明
NegativeKeywordListSelector 已套用條件的選取器。

withIds (string[] ids)

取得具有指定識別碼的負關鍵字清單。

您可以將一或多個條件套用至選取器。 條件鏈結會被視為 AND 作業。 例如，只有在條件 A 為 true 且條件 B 為 true 時，才會選取實體。 例如，下列呼叫只會選取負關鍵字清單 33333。

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

引數

名稱 類型 說明
Id string[] 負關鍵字的陣列會列出識別碼。 如需限制，請參閱 腳本執行限制。

傳回

類型 說明
NegativeKeywordListSelector 已套用識別碼的選取器。

withLimit (int 限制)

取得符合選取準則的前 n 個負數關鍵字清單。

引數

名稱 類型 說明
限制 int 要傳回的負關鍵字清單數目。 實際數目可能較少。

傳回

類型 說明
NegativeKeywordListSelector 已套用限制的選取器。

另請參閱