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 ASC par défaut.

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

ORDER BY metrics.impressions DESC, campaign.name ASC

Commande non autorisée:

• 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 cette approche à l'ordre des résultats, vous pouvez générer des rapports "N premiers", tels qu'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, sauf pour les champs des segments de date "principaux".
  • Les champs principaux des segments de date sont segments.date, segments.week, segments.month, segments.quarter et segments.year.
• Dans les champs de n'importe quel type de message, à l'exception des primitives (par exemple, Int64Value, StringValue, etc.)
• Pour les attributs de champs répétés de tout type de message, à l'exception des primitives (par exemple, Int64Value, StringValue, etc.)