NegativeKeywordListSelector

  • Artículo

Contiene los métodos para filtrar y ordenar listas de palabras clave negativas. Para obtener información sobre los selectores, vea Selectores.

Ejemplo de uso:

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

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

Métodos

Nombre del método Tipo de valor devuelto Descripción
get NegativeKeywordListIterator Obtiene un iterador usado para recorrer en iteración la lista de listas de palabras clave negativas.
orderBy(string orderBy) NegativeKeywordListSelector Aplica el orden especificado a las listas de palabras clave negativas seleccionadas.
withCondition(string condition) NegativeKeywordListSelector Aplica criterios de filtro a las listas de palabras clave negativas.
withIds(string[] ids) NegativeKeywordListSelector Obtiene listas de palabras clave negativas con los identificadores especificados.
withLimit(int limit) NegativeKeywordListSelector Obtiene las n principales listas de palabras clave negativas que coinciden con los criterios de selección.

Obtener

Obtiene un iterador que usa para recorrer en iteración la lista de listas de palabras clave negativas.

Valores devueltos

Tipo Descripción
NegativeKeywordListIterator Iterador usado para recorrer en iteración las listas de palabras clave negativas.

orderBy(string orderBy)

Aplica el orden especificado a las listas de palabras clave negativas seleccionadas.

Especifique el parámetro orderBy en el formulario "columnName orderDirection" donde:

  • columnName es una de las columnas admitidas
  • orderDirection es el orden en el que se ordenan los resultados. Establezca en ASC para ordenar los resultados en orden ascendente o DESC para ordenar los resultados en orden descendente. El valor predeterminado es ASC.

Por ejemplo, la llamada siguiente devuelve listas de palabras clave negativas en orden ascendente por MemberCount.

selector = selector.orderBy("MemberCount");

Los selectores admiten la ordenación de entidades solo por un campo. No puede ordenar la lista de entidades por campo x, y dentro de x por campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en llamadas de selector independientes, Scripts ordena la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Descripción
Orderby string Orden que se va a aplicar.

Valores devueltos

Tipo Descripción
NegativeKeywordListSelector Selector con orden aplicado.

withCondition(string condition)

Aplica criterios de filtro a las listas de palabras clave negativas.

Especifique el parámetro de condición en el formulario "columnName operator value" donde:

Operadores

El operador que use depende del tipo de columna. Los operadores distinguen mayúsculas de minúsculas. Por ejemplo, use STARTS_WITH en lugar de starts_with.

Operadores para columnas que contienen enteros y valores largos:

<
<=
>
>=
=
!=

Operadores para columnas que contienen valores dobles:

<
>

Operadores para columnas que contienen valores de cadena:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para columnas que contienen valores de enumeración:

=
!=
IN []
NOT_IN []

Operadores para columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas. Los nombres de columna distinguen mayúsculas de minúsculas.

Column Tipo Ejemplo
MemberCount Entero Número de palabras clave negativas en la lista.

withCondition("MemberCount > 10")
Nombre string Nombre de la lista de palabras clave negativas.

withCondition("Name = 'LIST NAME GOES HERE'")
ReferenceCount Entero Número de campañas a las que está asociada la lista.

withCondition("ReferenceCount > 10")
SharedSetId double Identificador de una lista de palabras clave negativas. Si simplemente usa esto para la comparación de igualdad, considere la posibilidad de usar el withIds método en su lugar.

withCondition("SharedSetId = 123456789")

Argumentos

Nombre Tipo Descripción
Condición string Condición que se va a agregar al selector.

Valores devueltos

Tipo Descripción
NegativeKeywordListSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene listas de palabras clave negativas con los identificadores especificados.

Puede aplicar una o varias condiciones a un selector. Una cadena de condiciones se considera una operación AND. Por ejemplo, la entidad solo se selecciona si la condición A es true Y la condición B es true. Por ejemplo, la llamada siguiente selecciona solo la lista de palabras clave negativas 33333.

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

Argumentos

Nombre Tipo Descripción
ids string[] Una matriz de palabras clave negativas enumera los identificadores. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Descripción
NegativeKeywordListSelector Selector con los identificadores aplicados.

withLimit(int limit)

Obtiene las n principales listas de palabras clave negativas que coinciden con los criterios de selección.

Argumentos

Nombre Tipo Descripción
límite Entero Número de listas de palabras clave negativas que se van a devolver. El número real puede ser menor.

Valores devueltos

Tipo Descripción
NegativeKeywordListSelector Selector con límite aplicado.

Consulte también