Ordenar resultados
É possível especificar a ordem das linhas na resposta usando a cláusula ORDER BY
,
que consiste em uma ou mais sequências separadas por vírgulas de:
FieldName ('ASC' | 'DESC')?
Se você não especificar ASC
ou DESC
após um nome de campo, o padrão da API Google Ads será ASC
.
A cláusula ORDER BY
a seguir classifica um relatório no nível da campanha por impressões decrescentes e nomes de campanhas crescentes:
ORDER BY metrics.impressions DESC, campaign.name ASC
Não é permitido ordenar:
- Por atributos de recursos não selecionados
- Por métricas não selecionadas
- Por segmentos não selecionados
- Para campos dos seguintes tipos:
MESSAGE
- Campos repetidos
- Atributos de campos repetidos
Limitar o número de resultados
É possível limitar o número total de resultados retornados usando a cláusula LIMIT
.
Combinando isso com a ordem dos resultados, é possível produzir os relatórios "N principais", como um relatório que contém as cinco campanhas com o maior número de impressões nos últimos 30 dias:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
A filtragem não é permitida:
- Em segmentos sem selecioná-los, exceto para campos de segmento de data "principal".
- Os campos do segmento de data principal são
segments.date
,segments.week
,segments.month
,segments.quarter
esegments.year
.
- Os campos do segmento de data principal são
- Em campos de qualquer tipo de mensagem, exceto primitivos (por exemplo: Int64Value, StringValue etc.)
- Em atributos de campos repetidos de qualquer tipo de mensagem, exceto primitivos (por exemplo: Int64Value, StringValue etc.)