AssetGroupSelector

Enthält die Methoden zum Filtern und Sortieren einer Liste von Ressourcengruppen. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

Methoden

Erhalten

Ruft einen Iterator ab, der zum Durchlaufen der Liste der Ressourcengruppen verwendet wird.

Rückgabewerte

orderBy(String orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Ressourcengruppen 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 Ressourcengruppen in aufsteigender Reihenfolge nach AverageCpc zurück.

selector = selector.orderBy("AverageCpc");

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

Rückgabewerte

withCondition(String condition)

Wendet Filterkriterien auf die Ressourcengruppen an.

Geben Sie den Bedingungsparameter im Format "columnName-Operatorwert" 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

Unterstützte Spalten für die Filterung von Ressourcengruppen. Bei den Namen wird die Groß-/Kleinschreibung beachtet.

Im Folgenden sind die Leistungsmetrikspalten aufgeführt, die Sie angeben können.

Im Folgenden sind die Entitätseigenschaften aufgeführt, die Sie angeben können.

Argumente

Rückgabewerte

withIds(string[] ids)

Ruft Ressourcengruppen 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 Ressourcengruppe 33333 aus.

var selector = Campaign.assetGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argumente

Rückgabewerte

withLimit(int limit)

Ruft die obersten n Ressourcengruppen ab, die den Auswahlkriterien entsprechen.

Argumente

Rückgabewerte

Siehe auch

Campaign.assetGroups()