Los selectores ayudan al programador a crear la consulta que recupera las entidades de Google Ads deseadas. Con los selectores, se puede acotar la lista de entidades recuperadas y ordenarla. La mayoría de los selectores tienen los siguientes métodos:
withCondition()- Agrega una condición a un selector. Si se usan varias condiciones, se unen mediante el operador AND. En otras palabras, el selector solo mostrará entidades que cumplan con todas las condiciones especificadas.
withIds()- Agrega una colección de IDs como condición. Una condición basada en un ID se combinará con el operador Y junto con todas las demás.
forDateRange()- Es necesario cuando una condición o cláusula de ordenamiento hace referencia a un campo Stats, como Ctr o Impressions. Si solicitas todas las campañas con más de 100 impresiones, las secuencias de comandos de Google Ads deberán conocer el período que se debe considerar.
orderBy()- Especifica el orden de las entidades mostradas.
withLimit()- Limita la cantidad de entidades que se muestran al valor especificado. Es particularmente útil junto con
orderBy()para obtener elementos como "10 palabras clave con la mayor cantidad de impresiones de ayer". De forma predeterminada, todos los selectores establecerán el límite en 50,000. Para aumentar el límite, especifica un límite de forma manual.
Se puede llamar a estos métodos en cualquier orden. Una excepción es orderBy(), donde el orden de las llamadas es importante: las llamadas múltiples 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 de forma descendente. Los resultados con valores de clics iguales 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 un Iterator mediante una llamada a selector.get().
Lee las Prácticas recomendadas para obtener sugerencias y trucos sobre el uso eficiente del selector.