Selectores

Los selectores ayudan al programador a construir la consulta que recupera las entidades de Google Ads deseadas. Con los selectores, se puede limitar la lista de entidades recuperadas y ordenarla. La mayoría de los selectores tienen lo siguiente métodos:

withCondition()
Agrega una condición a un selector. Si se usan varias condiciones, se En otras palabras, el selector solo mostrará entidades que cumpla con todas las condiciones especificadas.
withIds()
Agrega una colección de IDs como condición. Una condición basada en ID se unirá de forma Y junto con las demás.
forDateRange()
Es necesaria cuando una condición o cláusula de pedido hace referencia a un Stats, como CTR o impresiones. Si solicita todas las campañas con más de 100 impresiones Las secuencias de comandos de Google Ads deben indicar cuál es el período que se debe analizar.
orderBy()
Especifica el orden de las entidades que se muestran.
withLimit()
Limita la cantidad de entidades que se muestran al valor especificado. Sí es particularmente útil junto con orderBy() para recuperar elementos. como "10 palabras clave con más impresiones ayer". De forma predeterminada, todos los selectores establecerá el límite en 50,000. Para aumentar el límite, especifica manualmente un límite.

Se puede llamar a estos métodos en cualquier orden. Una excepción es orderBy(), en la que el orden de las llamadas sí importa: varias llamadas a este método especificarán varias cláusulas de orden y se aplicarán en orden. Considera el siguiente fragmento:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("metrics.clicks DESC")
    .orderBy("metrics.ctr ASC");

Los resultados se ordenarán por clics en orden descendente. Resultados con signo igual Los valores de los clics se ordenarán por CTR, en orden ascendente.

Las llamadas a los métodos de un selector se pueden encadenar. El siguiente código

var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");

se puede reescribir de forma más compacta:

var campaignSelector = AdsApp.campaigns()
  .withCondition("metrics.clicks > 10")
  .withCondition("metrics.impressions > 1000")
  .orderBy("metrics.impressions DESC")
  .forDateRange("YESTERDAY");

Una vez que se crea el selector, se puede obtener una Iterator desde él llamando selector.get()

Consulta las prácticas recomendadas para obtener sugerencias y trucos sobre el uso eficiente del selector.