Como ordenar e limitar resultados

Ordenar resultados

É possível especificar a ordem das linhas na sua 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 o nome de um campo, a API Google Ads o padrão é ASC.

A seguinte cláusula ORDER BY classifica um relatório no nível da campanha em ordem decrescente impressões e nome da campanha crescente:

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 ordenação de resultados, você pode produzir "top N" relatórios como um relatório com 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 "principal" segmentos de data.
    • 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.)