¿Qué son los selectores?

Los selectores te permiten aplicar criterios de filtrado y ordenación al recuperar entidades de Microsoft Advertising, como palabras clave y campañas. Los selectores proporcionan una funcionalidad aproximadamente equivalente a SQL WHERE y ORDER BY cláusulas. Los selectores incluyen los métodos siguientes:

  • withCondition() — Se usa para especificar las condiciones que las entidades deben cumplir para ser seleccionadas. Esto equivale a una cláusula SQL WHERE .

    Ejemplo: withCondition('Name STARTS_WITH "Contoso"')

    Puede aplicar una o más condiciones a un selector. Especificar varias 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.

  • withIds() — Se usa para especificar los ID de las entidades a seleccionar. Esto equivale a una cláusula SQL IN .

    Ejemplo: withIds(["1","2","3","4"])

  • forDateRange() — Se usa para devolver entidades con datos de rendimiento que coincidan con el intervalo de fechas especificado. Si una condición especifica una columna de métrica, debe incluirla forDateRange en la cadena del selector.

    Ejemplo: forDateRange("LAST_14_DAYS")

  • orderBy() — Se usa para ordenar las entidades que devuelve el selector por un campo especificado. Esto equivale a una cláusula SQL ORDER BY .

    Ejemplo: orderBy("Clicks DESC")

  • withLimit() — Se usa para devolver como máximo el número especificado de entidades. Esto equivale a una cláusula SQL TOP .

    Ejemplo: withLimit(50)

Dado que cada método devuelve el selector con los criterios de filtro aplicados, puede encadenar (mediante notación de puntos) varias condiciones para refinar los criterios de filtro. Por ejemplo:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

Para mejorar el rendimiento de la secuencia de comandos, use condiciones de filtro específicas para asegurarse de que solo recupera las entidades que desea. Después de obtener el selector, llame get() al método para recuperar un iterador que utilice para iterar a través de la lista de entidades.

var campaigns = selector.get();

O bien

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

La siguiente es la lista de selectores.

Pasos siguientes

Más información sobre iteradores

  • Last updated on