Classer et limiter les résultats

Classer les résultats

Vous pouvez spécifier l'ordre des lignes dans votre réponse à l'aide de la clause ORDER BY, qui se compose d'une ou de plusieurs séquences séparées par une virgule de:

FieldName ('ASC' | 'DESC')?

Si vous ne spécifiez pas ASC ni DESC après un nom de champ, l'API Google Ads utilise par défaut ASC.

La clause ORDER BY suivante trie un rapport au niveau de la campagne par nombre décroissant d'impressions et par ordre croissant de nom de la campagne:

ORDER BY metrics.impressions DESC, campaign.name ASC

L'ordre n'est pas autorisé:

  • Par attributs des ressources non sélectionnées
  • Par métriques non sélectionnées
  • Par segments non sélectionnés
  • Pour les champs des types suivants :
    • MESSAGE
    • Champs répétés
    • Attributs des champs répétés

Limiter le nombre de résultats

Vous pouvez limiter le nombre total de résultats renvoyés à l'aide de la clause LIMIT. En combinant ce classement avec le classement des résultats, vous pouvez générer des rapports "N premiers", comme un rapport contenant les cinq campagnes ayant enregistré le plus d'impressions au cours des 30 derniers jours:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Le filtrage n'est pas autorisé:

  • Sur les segments sans les sélectionner, à l'exception des champs de segment de date "principals".
    • Les champs de segment de date principaux sont segments.date, segments.week, segments.month, segments.quarter et segments.year.
  • Sur les champs de n'importe quel type de message, à l'exception des primitifs (par exemple : Int64Value, StringValue, etc.)
  • Sur les attributs des champs répétés de n'importe quel type de message, à l'exception des primitifs (par exemple : Int64Value, StringValue, etc.)