NegativeKeywordListSelector

Enthält die Methoden zum Filtern und Sortieren von Listen mit auszuschließenden Keywords. 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, mit dem die Liste der Listen mit auszuschließenden Keywords durchlaufen wird.
orderBy(string orderBy)	NegativeKeywordListSelector	Wendet die angegebene Reihenfolge auf die ausgewählten Listen mit auszuschließenden Keywords an.
withCondition(string condition)	NegativeKeywordListSelector	Wendet Filterkriterien auf die Listen mit auszuschließenden Keywords an.
withIds(string[] ids)	NegativeKeywordListSelector	Ruft Listen mit negativen Keywords mit den angegebenen IDs ab.
withLimit(int limit)	NegativeKeywordListSelector	Ruft die Listen mit den ersten n negativen Keywords ab, die den Auswahlkriterien entsprechen.

Abrufen

Ruft einen Iterator ab, um die Liste der Listen mit auszuschließenden Keywords zu durchlaufen.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListIterator	Ein Iterator, der zum Durchlaufen der Listen mit auszuschließenden Keywords verwendet wird.

orderBy(string orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Listen mit auszuschließenden Keywords an.

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

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

Der folgende Aufruf gibt beispielsweise Listen mit negativen Keywords in aufsteigender Reihenfolge nach MemberCount zurück.

selector = selector.orderBy("MemberCount");

Selektoren unterstützen die Sortierung von Entitäten nach nur einem Feld. Sie dürfen die Liste der Entitäten nicht nach dem Feld x und innerhalb von x nach dem Feld y usw. ordnen. 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 Listen mit auszuschließenden Keywords an.

Geben Sie den Bedingungsparameter im Format "Wert des Operators columnName" an, wobei:

• columnName ist eine der unterstützten Spalten.
• operator ist einer der unterstützten Operatoren.

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 Keywords in der Liste. withCondition("MemberCount > 10")
Name	string	Der Name der Liste der negativen Schlüsselwörter (Keyword). 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 Liste mit negativen Schlüsselwörtern (Keyword). Wenn Sie dies einfach für den Gleichheitsvergleich verwenden, sollten Sie stattdessen die withIds Methode verwenden. withCondition("SharedSetId = 123456789")

Argumente

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

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListSelector	Selector mit der angewendeten Bedingung.

withIds(string[] ids)

Ruft Listen mit negativen Keywords mit den angegebenen IDs ab.

Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Eine Kette von Bedingungen wird als UND-Vorgang betrachtet. Beispielsweise wird das Objekt nur ausgewählt, wenn Bedingung A wahr UND Bedingung B wahr ist. Der folgende Aufruf wählt beispielsweise nur die Liste mit negativen Keywords 33333 aus.

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

Argumente

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

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListSelector	Selector mit den angewendeten IDs.

withLimit(int limit)

Ruft die Listen mit den ersten n negativen Keywords ab, die den Auswahlkriterien entsprechen.

Argumente

Name	Typ	Beschreibung
Begrenzung	int	Die Anzahl der Listen mit negativen Keywords, die zurückgegeben werden sollen. Die tatsächliche Anzahl kann geringer sein.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListSelector	Selektor mit angewendetem Grenzwert.

Siehe auch

• NegativeKeywordListIterator
• NegativeKeywordList