NegativeKeywordListSelector

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

Exemplo de utilização:

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

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

Metodologia

Nome do método Tipo de Devolução Descrição
Obter NegativeKeywordListIterator Obtém um iterador usado 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 string) NegativeKeywordListSelector Aplica critérios de filtro às listas de palavras-chave negativas.
withIds(string[] ids) NegativeKeywordListSelector Obtém listas de palavras-chave negativas com as IDs especificadas.
withLimit(int limit) NegativeKeywordListSelector Obtém as principais listas de palavras-chave negativas que correspondem aos critérios de seleção.

Obter

Obtém um iterador usa 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" onde:

  • columnName é uma das colunas suportadas
  • orderDirection é a ordem pela qual ordenar os resultados. Defina ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. O padrão é ASC.

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

selector = selector.orderBy("MemberCount");

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

Argumentos

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

Devoluções

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

withCondition(condição string)

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

Especifique o parâmetro de condição no formulário, "columnName operator value" onde:

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 de caracteres:

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:
NúmeroDeMembros int O número de palavras-chave negativas na lista.

withCondition("MemberCount > 10")
Name cadeia Nome da lista de palavras-chave negativas.

withCondition("Name = 'LIST NAME GOES HERE'")
Contagem de Referências int O número de campanhas associadas à lista.

withCondition("ReferenceCount > 10")
SharedSetId duplo O ID de uma lista de palavras-chave negativa. Se você simplesmente usar isso para comparação de igualdade, considere usar o withIds método em vez disso.

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 as IDs especificadas.

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 IDs de listas de palavras-chave negativas. Para limites, consulte Limites de execução de scripts.

Devoluções

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

withLimit(int limit)

Obtém as 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

  • Last updated on