Condividi tramite

NegativeKeywordListSelector

  • Articolo

Contiene i metodi per filtrare e ordinare gli elenchi di parole chiave negative. Per informazioni sui selettori, vedere Selettori.

Utilizzo di esempio:

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

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

Metodi

Nome metodo Tipo restituito Descrizione
Ottieni NegativeKeywordListIterator Ottiene un iteratore utilizzato per scorrere l'elenco di elenchi di parole chiave negative.
orderBy(string orderBy) NegativeKeywordListSelector Applica l'ordinamento specificato agli elenchi di parole chiave negative selezionati.
withCondition(string condition) NegativeKeywordListSelector Applica i criteri di filtro agli elenchi di parole chiave negative.
withIds(string[] ids) NegativeKeywordListSelector Ottiene elenchi di parole chiave negative con gli ID specificati.
withLimit(int limit) NegativeKeywordListSelector Ottiene le prime n parole chiave negative che corrispondono ai criteri di selezione.

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco di elenchi di parole chiave negative.

Restituisce

Tipo Descrizione
NegativeKeywordListIterator Iteratore usato per scorrere gli elenchi di parole chiave negative.

orderBy(string orderBy)

Applica l'ordinamento specificato agli elenchi di parole chiave negative selezionati.

Specificare il parametro orderBy nel formato "columnName orderDirection" dove:

  • columnName è una delle colonne supportate
  • orderDirection è l'ordine in cui ordinare i risultati. Impostare su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. Il valore predefinito è ASC.

Ad esempio, la chiamata seguente restituisce elenchi di parole chiave negative in ordine crescente in base a MemberCount.

selector = selector.orderBy("MemberCount");

I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco di entità per campo x e all'interno di x per campo y e così via. Se si specificano più chiamate orderBy() in una catena o in chiamate selettore separate, Script ordina l'elenco di entità usando il campo specificato nell'ultima orderBy() chiamata. 

Argomenti

Nome Tipo Descrizione
Orderby stringa Ordinamento da applicare.

Restituisce

Tipo Descrizione
NegativeKeywordListSelector Selettore con ordinamento applicato.

withCondition(string condition)

Applica i criteri di filtro agli elenchi di parole chiave negative.

Specificare il parametro condition nel formato "columnName operator value" dove:

Operatori

L'operatore usato dipende dal tipo della colonna. Gli operatori fanno distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH anziché starts_with.

Operatori per le colonne che contengono valori interi e valori lunghi:

<
<=
>
>=
=
!=

Operatori per le colonne che contengono valori double:

<
>

Operatori per le colonne che contengono valori stringa:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatori per le colonne che contengono valori di enumerazione:

=
!=
IN []
NOT_IN []

Operatori per le colonne che contengono una matrice di stringhe:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonne supportate. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole.

Colonna Tipo Esempio
MemberCount int Numero di parole chiave negative nell'elenco.

withCondition("MemberCount > 10")
Nome stringa Nome dell'elenco di parole chiave negative.

withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount int Numero di campagne a cui è associato l'elenco.

withCondition("ReferenceCount > 10")
SharedSetId Doppia ID di un elenco di parole chiave negative. Se si usa questo metodo per il confronto di uguaglianza, è consigliabile usare invece il withIds metodo .

withCondition("SharedSetId = 123456789")

Argomenti

Nome Tipo Descrizione
Condizione stringa Condizione da aggiungere al selettore.

Restituisce

Tipo Descrizione
NegativeKeywordListSelector Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene elenchi di parole chiave negative con gli ID specificati.

È possibile applicare una o più condizioni a un selettore. Una catena di condizioni è considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è true E la condizione B è true. Ad esempio, la chiamata seguente seleziona solo parole chiave negative elenco 33333.

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

Argomenti

Nome Tipo Descrizione
Id string[] Matrice di parole chiave negative che elenca gli ID. Per i limiti, vedere Limiti di esecuzione dello script.

Restituisce

Tipo Descrizione
NegativeKeywordListSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene le prime n parole chiave negative che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di elenchi di parole chiave negative da restituire. Il numero effettivo può essere minore.

Restituisce

Tipo Descrizione
NegativeKeywordListSelector Selettore con limite applicato.

Vedere anche