Como ordenar e limitar resultados

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 o nome de um campo, a API Google Ads 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 de campanha crescente:

ORDER BY metrics.impressions DESC, campaign.name ASC

Não é permitido ordenar os seguintes itens:

• 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 de resultados, você pode produzir relatórios "N principais", como um relatório contendo 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 nos campos de segmento de data "principal".
  • Os campos de segmento de data principal 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.)