Como ordenar e limitar resultados

Como 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, a API Google Ads vai usar ASC como 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. Combinando isso com a ordenação de resultados, você pode produzir relatórios "top N", como um relatório que contém as cinco campanhas com as impressões mais altas 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 para campos de segmento de datas "principais".
  • Os campos principais do segmento de data são segments.date, segments.week, segments.month, segments.quarter e segments.year.
• 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.)