Classer et limiter les résultats

Le langage de requête Google Ads vous permet de trier et de limiter les lignes renvoyées dans vos réponses aux requêtes à l'aide des clauses ORDER BY et LIMIT.

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 ou DESC après un nom de champ, l'API Google Ads utilise par défaut ASC. Si vous omettez complètement la clause ORDER BY, l'ordre des lignes renvoyées n'est pas déterministe.

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

ORDER BY metrics.impressions DESC, campaign.name ASC
  • 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 avec un entier positif (1 ou supérieur ; LIMIT 0 n'est pas valide). En combinant cette fonctionnalité avec le tri des résultats, vous pouvez générer des rapports "top N", par exemple 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

Filtrer les résultats

Lorsque vous combinez des filtres WHERE avec ORDER BY et LIMIT, tenez compte des restrictions de filtrage suivantes :

  • Le filtrage n'est pas autorisé sur les segments sans les sélectionner, à l'exception des champs de segment de date "principaux" (segments.date, segments.week, segments.month, segments.quarter et segments.year).
  • Le filtrage n'est pas autorisé directement sur les champs MESSAGE composites (sauf pour les messages de wrapper primitifs tels que Int64Value et StringValue). Filtrez plutôt sur leurs sous-champs scalaires primitifs (int64, string, bool) ou d'énumération.
  • Le filtrage n'est pas autorisé sur les attributs MESSAGE composites des champs répétés. Seuls les sous-champs scalaires primitifs (int64, string, bool), d'énumération ou de wrapper primitif peuvent être filtrés.
Précédent
Sensibilité à la casse