Ordenar e limitar 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 Reporting vai usar ASC por padrão.

A cláusula ORDER BY a seguir classifica um relatório de performance por impressões em ordem decrescente e IDs de oferta de produto em ordem crescente:

ORDER BY metrics.impressions DESC, segments.offer_id ASC

ORDER BY não é permitido em métricas ou segmentos não selecionados.

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 "top N", como um relatório com os cinco produtos que tiveram mais impressões nos últimos 30 dias:

Exemplo

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-31'
ORDER BY metrics.impressions DESC
LIMIT 5;

Observação: o número máximo de linhas que podem ser recuperadas de uma consulta é 1.000, mesmo que o limite seja maior. Você precisa emitir solicitações consecutivas com o pageToken para os resultados restantes. Para saber mais, consulte nosso guia de paginação.

Não é possível filtrar (cláusula WHERE) métricas sem selecioná-las.