Classer et limiter 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, Reporting API utilise par défaut ASC.

La clause ORDER BY suivante trie un rapport sur les performances par nombre décroissant d'impressions et par ordre croissant d'ID d'offre de produit :

ORDER BY metrics.impressions DESC, segments.offer_id ASC

ORDER BY n'est pas autorisé sur les métriques non sélectionnées ni sur les segments non sélectionné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 produits ayant enregistré le plus d'impressions au cours des 30 derniers jours :

Exemple

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-31'
ORDER BY metrics.impressions DESC
LIMIT 5;

Remarque : Le nombre maximal de lignes que vous pouvez récupérer à partir d'une requête est de 1 000, même si votre limite est plus élevée. Vous devez émettre des requêtes consécutives avec le pageToken pour les résultats restants. Pour en savoir plus, consultez notre guide sur la pagination.

Vous n'êtes pas autorisé à filtrer (clause WHERE) sur des métriques sans les sélectionner.