Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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écroissant d'impressions et par ordre croissant de nom de campagne :
ORDER BY metrics.impressions DESC, campaign.name ASC
Les commandes ne sont pas autorisées :
- Par attributs des ressources non sélectionnées
- Par métriques non sélectionnées
- Par les 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 ce classement avec le classement des résultats, vous pouvez générer des rapports "N premiers", 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 sans les sélectionner, à l'exception des champs de segment de date "de base".
- Les principaux champs de segment de date sont
segments.date
, segments.week
, segments.month
, segments.quarter
et segments.year
.
- Sur les champs de n'importe quel type de message, à l'exception des types primitifs (par exemple : Int64Value, StringValue, etc.)
- Sur les attributs des champs répétés de n'importe quel type de message, à l'exception des types primitifs (par exemple :
Int64Value, StringValue, etc.)
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eYou can control the order of results using the \u003ccode\u003eORDER BY\u003c/code\u003e clause, specifying fields and sort direction (ASC or DESC).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLIMIT\u003c/code\u003e clause lets you restrict the number of returned results, enabling "top N" reports when combined with \u003ccode\u003eORDER BY\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOrdering is disallowed by attributes of non-selected resources, by non-selected metrics or segments, and for fields of type \u003ccode\u003eMESSAGE\u003c/code\u003e, repeated fields, or attributes of repeated fields.\u003c/p\u003e\n"],["\u003cp\u003eFiltering is restricted for segments without selection (excluding core date segments), fields of non-primitive message types, and attributes of repeated fields with non-primitive message types.\u003c/p\u003e\n"]]],[],null,["Order results\n-------------\n\nYou can specify the order of rows in your response using the `ORDER BY` clause,\nwhich consists of one or more comma-separated sequences of: \n\n FieldName ('ASC' | 'DESC')?\n\nIf you don't specify `ASC` or `DESC` after a field name, the Google Ads API defaults to\n`ASC`.\n\nThe following `ORDER BY` clause sorts a campaign-level report by descending\nimpressions and ascending campaign name: \n\n ORDER BY metrics.impressions DESC, campaign.name ASC\n\nOrdering is not allowed:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- By attributes of non-selected resources\n- By non-selected metrics\n- By non-selected segments\n- For fields of the following types:\n - `MESSAGE`\n - Repeated fields\n - Attributes of repeated fields\n\nLimit the number of results\n---------------------------\n\nYou can limit the total number of results returned using the `LIMIT` clause.\nCombining this with results ordering, you can produce \"top N\" reports,\nsuch as a report containing the five campaigns with the highest impressions\nover the last 30 days: \n\n SELECT\n campaign.id,\n campaign.name,\n metrics.impressions\n FROM campaign\n WHERE segments.date DURING LAST_30_DAYS\n ORDER BY metrics.impressions DESC\n LIMIT 5\n\nFiltering is not allowed:\n\n- On segments without selecting them, except for \"core\" date segment fields.\n - The core date segment fields are `segments.date`, `segments.week`, `segments.month`, `segments.quarter`, and `segments.year`.\n- On fields of any message type except primitives (e.g.: Int64Value, StringValue, etc.)\n- On attributes of repeated fields of any message type except primitives (e.g.: Int64Value, StringValue, etc.)"]]