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'impressions par ordre décroissant et par nom de campagne dans l'ordre croissant:

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 cela avec le classement des résultats, vous pouvez générer des "N premiers" rapports, 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 qui n'ont pas été sélectionnés, à l'exception des champs de segment de date "principaux".
  • Les principaux champs associés au segment de date sont segments.date, segments.week, segments.month, segments.quarter et segments.year.
• Dans les champs de tout type de message, à l'exception des champs primitifs (par exemple : Int64Value, StringValue, etc.)
• Pour les attributs de champs répétés de n'importe quel type de message, à l'exception des rôles primitifs (par exemple : Int64Value, StringValue, etc.)