Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Ordina risultati
Puoi specificare l'ordine delle righe nella risposta utilizzando la clausola ORDER BY
,
che consiste in una o più sequenze separate da virgole di:
FieldName ('ASC' | 'DESC')?
Se non specifichi ASC
o DESC
dopo il nome di un campo, l'API Google Ads utilizza
ASC
per impostazione predefinita.
La seguente clausola ORDER BY
ordina un report a livello di campagna in base alle impressioni in ordine decrescente e al nome della campagna in ordine crescente:
ORDER BY metrics.impressions DESC, campaign.name ASC
L'ordinazione non è consentita:
- Per attributi delle risorse non selezionate
- Per metriche non selezionate
- Per segmenti non selezionati
- Per i campi dei seguenti tipi:
MESSAGE
- Campi ripetuti
- Attributi dei campi ripetuti
Limitare il numero di risultati
Puoi limitare il numero totale di risultati restituiti utilizzando la clausola LIMIT
.
Se combini questa funzionalità con l'ordinamento dei risultati, puoi generare report "I primi N",
ad esempio un report contenente le cinque campagne con il maggior numero di impressioni
negli ultimi 30 giorni:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
Il filtro non è consentito:
- Sui segmenti senza selezionarli, ad eccezione dei campi dei segmenti di date "principali".
- I campi del segmento di date principali sono
segments.date
, segments.week
,
segments.month
, segments.quarter
e segments.year
.
- Nei campi di qualsiasi tipo di messaggio, ad eccezione dei primitivi (ad es. Int64Value, StringValue e così via)
- Sugli attributi dei campi ripetuti di qualsiasi tipo di messaggio, ad eccezione dei primitivi (ad es.
Int64Value, StringValue e così via)
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 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.)"]]