Mit der Google Ads Query Language können Sie die in Ihren Abfrageantworten zurückgegebenen Zeilen mit den Klauseln ORDER BY und LIMIT sortieren und begrenzen.
Ergebnisse sortieren
Mit der ORDER BY-Klausel können Sie die Reihenfolge der Zeilen in Ihrer Antwort angeben. Sie besteht aus einer oder mehreren durch Kommas getrennten Sequenzen aus:
FieldName (ASC | DESC)?
Wenn Sie nach einem Feldnamen ASC oder DESC nicht angeben, wird in der Google Ads API standardmäßig ASC verwendet. Wenn Sie die ORDER BY-Klausel vollständig weglassen, ist die Reihenfolge der zurückgegebenen Zeilen nicht deterministisch.
Mit der folgenden ORDER BY-Klausel wird ein Bericht auf Kampagnenebene nach absteigenden Impressionen und aufsteigendem Kampagnennamen sortiert:
ORDER BY metrics.impressions DESC, campaign.name ASC
- Über Attribute nicht ausgewählter Ressourcen
- Nach nicht ausgewählten Messwerten
- Durch nicht ausgewählte Segmente
- Für Felder der folgenden Typen:
MESSAGE- Wiederkehrende Felder
- Attribute wiederkehrender Felder
Anzahl der Ergebnisse begrenzen
Sie können die Gesamtzahl der zurückgegebenen Ergebnisse mit der LIMIT-Klausel und einer positiven Ganzzahl (1 oder höher; LIMIT 0 ist ungültig) begrenzen. In Kombination mit der Sortierung der Ergebnisse können Sie Berichte mit den „N Top-Ergebnissen“ erstellen, z. B. einen Bericht mit den fünf Kampagnen mit den meisten Impressionen in den letzten 30 Tagen:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
Ergebnisse filtern
Wenn Sie WHERE-Filter mit ORDER BY und LIMIT kombinieren, gelten die folgenden Filterbeschränkungen:
- Das Filtern von Segmenten ist nur zulässig, wenn sie ausgewählt sind. Ausnahmen sind die „Core“-Datumssegmentfelder (
segments.date,segments.week,segments.month,segments.quarterundsegments.year). - Das Filtern von zusammengesetzten
MESSAGE-Feldern ist nicht direkt zulässig (mit Ausnahme von Wrapper-Nachrichten für primitive Typen wieInt64ValueundStringValue). Filtern Sie stattdessen nach den zugehörigen skalaren Unterfeldern (int64,string,bool) oder Enum-Unterfeldern. - Das Filtern ist für zusammengesetzte
MESSAGE-Attribute von wiederholten Feldern nicht zulässig. Es können nur primitive skalare (int64,string,bool), Enum- oder primitive Wrapper-Unterfelder gefiltert werden.