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írgula de:
FieldName ('ASC' | 'DESC')?
Se você não especificar ASC
ou DESC
depois de um nome de campo, a API Google Ads vai usar ASC
por padrão.
A cláusula ORDER BY
a seguir classifica um relatório no nível da campanha por impressões decrescentes e nome da campanha crescente:
ORDER BY metrics.impressions DESC, campaign.name ASC
Não é permitido:
- 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
.
Ao combinar isso com a ordenação de resultados, você pode gerar relatórios "N principais", como um relatório com as cinco campanhas com mais 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
Não é permitido filtrar:
- Em segmentos sem seleção, exceto campos de segmento de data "principais".
- Os campos principais de segmento de data são
segments.date
,segments.week
,segments.month
,segments.quarter
esegments.year
.
- Os campos principais de segmento de data 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.)