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.quarteresegments.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.)