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 les réponses à vos 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 ASC par défaut. 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 impressions décroissantes et par nom de campagne croissant :

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Par attributs de 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 de 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 LIMIT clause avec un entier positif (1 ou plus ; LIMIT 0 n'est pas valide). En combinant cette clause avec le tri des résultats, vous pouvez générer des rapports "N premiers", par exemple un rapport contenant les cinq campagnes ayant généré 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 (à l'exception des messages 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 de champs répétés ; seuls les sous-champs scalaires primitifs (int64, string, bool), d'énumération ou wrapper primitifs peuvent être filtrés.
Précédent
Sensibilité à la casse