Compartilhar via

NegativeKeywordListSelector

  • Artigo

Contém os métodos para filtrar e ordenar listas de palavras-chave negativas. Para obter informações sobre seletores, consulte Seletores.

Utilização de exemplo:

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

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

Métodos

Nome do Método Tipo de Devolução Descrição
obter NegativeKeywordListIterator Obtém um iterador utilizado para iterar através da lista de listas de palavras-chave negativas.
orderBy(string orderBy) NegativeKeywordListSelector Aplica a ordenação especificada às listas de palavras-chave negativas selecionadas.
withCondition(condição de cadeia) NegativeKeywordListSelector Aplica critérios de filtro às listas de palavras-chave negativas.
withIds(string[] ids) NegativeKeywordListSelector Obtém listas de palavras-chave negativas com os IDs especificados.
withLimit(int limit) NegativeKeywordListSelector Obtém as n principais listas de palavras-chave negativas que correspondem aos critérios de seleção.

obter

Obtém um iterador utilizado para iterar através da lista de listas de palavras-chave negativas.

Devoluções

Tipo Descrição
NegativeKeywordListIterator Um iterador utilizado para iterar através das listas de palavras-chave negativas.

orderBy(string orderBy)

Aplica a ordenação especificada às listas de palavras-chave negativas selecionadas.

Especifique o parâmetro orderBy no formulário "columnName orderDirection" em que:

  • columnName é uma das colunas suportadas
  • orderDirection é a ordem para ordenar os resultados. Defina como ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. A predefinição é ASC.

Por exemplo, a chamada seguinte devolve listas de palavras-chave negativas por ordem ascendente por MemberCount.

selector = selector.orderBy("MemberCount");

Os seletores suportam a ordenação de entidades apenas por um campo. Não pode ordenar a lista de entidades por campo x e dentro de x por campo y, etc. Se especificar mais do que uma orderBy() chamada numa cadeia ou em chamadas de seletor separadas, os scripts ordenam a lista de entidades utilizando o campo especificado na última orderBy() chamada. 

Argumentos

Name Tipo Descrição
orderBy cadeia A ordenação a aplicar.

Devoluções

Tipo Descrição
NegativeKeywordListSelector Seletor com ordenação aplicada.

withCondition(condição de cadeia)

Aplica critérios de filtro às listas de palavras-chave negativas.

Especifique o parâmetro condition no formulário "columnName operator value" em que:

Operadores

O operador que utilizar depende do tipo da coluna. Os operadores são sensíveis às maiúsculas e minúsculas. Por exemplo, utilize STARTS_WITH em vez de starts_with.

Operadores para colunas que contêm números inteiros e valores longos:

<
<=
>
>=
=
!=

Operadores para colunas que contêm valores duplos:

<
>

Operadores para colunas que contêm valores de cadeia:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para colunas que contêm valores de enumeração:

=
!=
IN []
NOT_IN []

Operadores para colunas que contêm uma matriz de cadeias:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas Suportadas. Os nomes das colunas são sensíveis às maiúsculas e minúsculas.

Coluna Tipo Exemplos:
MemberCount int O número de palavras-chave negativas na lista.

withCondition("MemberCount > 10")
Name cadeia O nome da lista de palavras-chave negativa.

withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount int O número de campanhas a que a lista está associada.

withCondition("ReferenceCount > 10")
SharedSetId duplo O ID de uma lista de palavras-chave negativas. Se utilizar simplesmente esta opção para comparação de igualdade, considere utilizar o withIds método .

withCondition("SharedSetId = 123456789")

Argumentos

Name Tipo Descrição
condição cadeia A condição a adicionar ao seletor.

Devoluções

Tipo Descrição
NegativeKeywordListSelector Seletor com a condição aplicada.

withIds(string[] ids)

Obtém listas de palavras-chave negativas com os IDs especificados.

Pode aplicar uma ou mais condições a um seletor. Uma cadeia de condições é considerada uma operação E. Por exemplo, a entidade só é selecionada se a condição A for verdadeira E a condição B for verdadeira. Por exemplo, a chamada seguinte seleciona apenas a lista de palavras-chave negativas 33333.

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

Argumentos

Name Tipo Descrição
IDs cadeia[] Uma matriz de palavras-chave negativas lista IDs. Para obter limites, veja Limites de execução de scripts.

Devoluções

Tipo Descrição
NegativeKeywordListSelector Seletor com os IDs aplicados.

withLimit(int limit)

Obtém as n principais listas de palavras-chave negativas que correspondem aos critérios de seleção.

Argumentos

Name Tipo Descrição
limite int O número de listas de palavras-chave negativas a devolver. O número real pode ser menor.

Devoluções

Tipo Descrição
NegativeKeywordListSelector Seletor com limite aplicado.

Consulte também