LabelSelector

Contiene los métodos para filtrar y ordenar una lista de etiquetas en la cuenta. Para obtener información sobre los selectores, consulte Selectores.

Métodos

Nombre del método Tipo de valor devuelto Description
get LabelIterator Obtiene un iterador que se usa para iterar a través de la lista de etiquetas.
orderBy(string orderBy) LabelSelector Aplica el orden especificado a las etiquetas seleccionadas.
withCondition(condición de cadena) LabelSelector Aplica criterios de filtro a las etiquetas.
withIds(string[] ids) LabelSelector Obtiene etiquetas con los identificadores especificados.
withLimit(int limit) LabelSelector Obtiene las n etiquetas principales que coinciden con los criterios de selección.

obtener

Obtiene un iterador que se usa para iterar a través de la lista de etiquetas.

Valores devueltos

Tipo Description
LabelIterator Iterador usado para iterar a través de las etiquetas seleccionadas.

orderBy(string orderBy)

Aplica el orden especificado a las etiquetas 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 ordenarán los resultados. Establezca 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 siguiente llamada devuelve los resultados en orden ascendente por el nombre de la etiqueta.

selector = selector.orderBy("Name");

Si especifica una columna de recuento, como KeywordCount, el selector ordena por recuento y, a continuación, por nombre en orden ascendente.

Los selectores admiten entidades de orden por un solo campo. No puede ordenar la lista de entidades por el campo x, y dentro de x por el campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en selectores independientes, los scripts ordenan la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Description
orderBy string La orden de aplicar.

Valores devueltos

Tipo Description
LabelSelector Selector con orden aplicado.

withCondition(condición de cadena)

Aplica criterios de filtro a las etiquetas.

Especifique el parámetro de condición en el formulario "valor del operador columnName" 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 de 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 de columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas para el filtrado de etiquetas. Los nombres de columna distinguen mayúsculas de minúsculas.

Column Tipo Ejemplo
Nombre string El nombre del sello.

withCondition("Name = 'foo'")
KeywordCount string El número de palabras clave asociadas a la etiqueta.

withCondition("KeywordCount > 5")
AdCount string El número de anuncios asociados a la etiqueta.

withCondition("AdCount > 5")
AdGroupCount string El número de grupos de anuncios asociados a la etiqueta.

withCondition("AdGroupCount > 5")
CampaignCount string Número de campañas asociadas a la etiqueta.

withCondition("CampaignCount > 5")

Argumentos

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

Valores devueltos

Tipo Description
LabelSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene etiquetas con los identificadores especificados.

Puede aplicar una o más 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 verdadera Y la condición B es verdadera. Por ejemplo, la siguiente llamada selecciona solo la etiqueta 33333.

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

Argumentos

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

Valores devueltos

Tipo Description
LabelSelector con los identificadores aplicados.

withLimit(int limit)

Obtiene las n etiquetas principales que coinciden con los criterios de selección.

Argumentos

Nombre Tipo Description
límite Entero El número de etiquetas que se van a devolver. El número real puede ser menor.

Valores devueltos

Tipo Description
LabelSelector Selector con límite aplicado.

Vea también

  • Last updated on