Freigeben über

NegativeKeywordListSelector

  • Artikel

Enthält die Methoden zum Filtern und Sortieren negativer Schlüsselwörterlisten. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

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

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

Methoden

Methodenname Rückgabetyp Beschreibung
get NegativeKeywordListIterator Ruft einen Iterator ab, der zum Durchlaufen der Liste mit negativen Schlüsselwörtern verwendet wird.
orderBy(string orderBy) NegativeKeywordListSelector Wendet die angegebene Reihenfolge auf die ausgewählten negativen Schlüsselwörterlisten an.
withCondition(string condition) NegativeKeywordListSelector Wendet Filterkriterien auf die negativen Schlüsselwörterlisten an.
withIds(string[] ids) NegativeKeywordListSelector Ruft negative Schlüsselwörterlisten mit den angegebenen IDs ab.
withLimit(int limit) NegativeKeywordListSelector Ruft die obersten n negativen Schlüsselwörterlisten ab, die den Auswahlkriterien entsprechen.

Erhalten

Ruft einen Iterator ab, der verwendet, um die Liste mit negativen Schlüsselwörtern zu durchlaufen.

Rückgabewerte

Typ Beschreibung
NegativeKeywordListIterator Ein Iterator, der verwendet wird, um die negativen Schlüsselwörterlisten zu durchlaufen.

orderBy(string orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten negativen Schlüsselwörterlisten an.

Geben Sie den orderBy-Parameter im Format "columnName orderDirection" an, wobei:

  • columnName ist eine der unterstützten Spalten.
  • orderDirection ist die Reihenfolge, in der die Ergebnisse sortiert werden. Legen Sie auf ASC fest, um die Ergebnisse in aufsteigender Reihenfolge zu sortieren, oder AUF DESC, um die Ergebnisse in absteigender Reihenfolge zu sortieren. Der Standardwert ist ASC.

Der folgende Aufruf gibt beispielsweise negative Schlüsselwörterlisten in aufsteigender Reihenfolge nach MemberCount zurück.

selector = selector.orderBy("MemberCount");

Selektoren unterstützen das Sortieren von Entitäten nur nach einem Feld. Sie dürfen die Liste der Entitäten nicht nach Feld x und innerhalb von x nach Feld y usw. sortieren. Wenn Sie mehr als einen orderBy() Aufruf in einer Kette oder in separaten Selektoraufrufen angeben, sortiert Scripts die Liste der Entitäten mithilfe des im letzten orderBy() Aufruf angegebenen Felds. 

Argumente

Name Typ Beschreibung
Orderby string Die anzuwendende Reihenfolge.

Rückgabewerte

Typ Beschreibung
NegativeKeywordListSelector Selektor mit angewendeter Reihenfolge.

withCondition(string condition)

Wendet Filterkriterien auf die negativen Schlüsselwörterlisten an.

Geben Sie den Bedingungsparameter im Format "columnName-Operatorwert" an, wobei:

Operatoren

Der operator, den Sie verwenden, hängt vom Typ der Spalte ab. Bei Operatoren wird die Groß-/Kleinschreibung beachtet. Verwenden Sie beispielsweise STARTS_WITH anstelle von starts_with.

Operatoren für Spalten, die ganze Zahlen und lange Werte enthalten:

<
<=
>
>=
=
!=

Operatoren für Spalten, die doppelte Werte enthalten:

<
>

Operatoren für Spalten, die Zeichenfolgenwerte enthalten:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatoren für Spalten, die Enumerationswerte enthalten:

=
!=
IN []
NOT_IN []

Operatoren für Spalten, die ein Array von Zeichenfolgen enthalten:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Unterstützte Spalten. Bei Spaltennamen wird die Groß-/Kleinschreibung beachtet.

Spalte Typ Beispiel
MemberCount int Die Anzahl der negativen Schlüsselwörter in der Liste.

withCondition("MemberCount > 10")
Name string Der negative Schlüsselwort (keyword) Namen der Liste.

withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount int Die Anzahl der Kampagnen, denen die Liste zugeordnet ist.

withCondition("ReferenceCount > 10")
SharedSetId double Die ID einer negativen Schlüsselwort (keyword) Liste. Wenn Sie dies einfach für den Gleichheitsvergleich verwenden, sollten Sie stattdessen die withIds -Methode verwenden.

withCondition("SharedSetId = 123456789")

Argumente

Name Typ Beschreibung
Zustand string Die Bedingung, die dem Selektor hinzugefügt werden soll.

Rückgabewerte

Typ Beschreibung
NegativeKeywordListSelector Selektor mit angewendeter Bedingung.

withIds(string[] ids)

Ruft negative Schlüsselwörterlisten mit den angegebenen IDs ab.

Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Eine Kette von Bedingungen wird als AND-Vorgang betrachtet. Beispielsweise wird die Entität nur ausgewählt, wenn Bedingung A true ist UND Bedingung B wahr ist. Der folgende Aufruf wählt beispielsweise nur die negative Schlüsselwörterliste 33333 aus.

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

Argumente

Name Typ Beschreibung
ids string[] Ein Array negativer Schlüsselwort (keyword) listet IDs auf. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
NegativeKeywordListSelector Selektor mit den angewendeten IDs.

withLimit(int limit)

Ruft die obersten n negativen Schlüsselwörterlisten ab, die den Auswahlkriterien entsprechen.

Argumente

Name Typ Beschreibung
Begrenzung int Die Anzahl der zurückzugebenden negativen Schlüsselwörterlisten. Die tatsächliche Zahl kann kleiner sein.

Rückgabewerte

Typ Beschreibung
NegativeKeywordListSelector Selektor mit angewendetem Limit.

Siehe auch