Język zapytań Google Ads umożliwia sortowanie i ograniczanie liczby wierszy zwracanych w odpowiedziach na zapytania za pomocą klauzul ORDER BY i LIMIT.
Wyniki zamówienia
Kolejność wierszy w odpowiedzi możesz określić za pomocą klauzuli ORDER BY, która składa się z co najmniej 1 ciągu rozdzielonego przecinkami:
FieldName (ASC | DESC)?
Jeśli po nazwie pola nie określisz ASC ani DESC, interfejs Google Ads API domyślnie przyjmie wartość ASC. Jeśli całkowicie pominiesz klauzulę ORDER BY, kolejność zwracanych wierszy będzie nieokreślona.
Ten klauzula ORDER BY sortuje raport na poziomie kampanii według malejącej liczby wyświetleń i rosnącej nazwy kampanii:
ORDER BY metrics.impressions DESC, campaign.name ASC
- według atrybutów niewybranych zasobów,
- Według niewybranych danych
- Według niewybranych segmentów
- W przypadku pól tych typów:
MESSAGE- Pola powtarzane
- Atrybuty pól powtarzanych
Ograniczanie liczby wyników
Możesz ograniczyć łączną liczbę zwracanych wyników za pomocą klauzuli LIMIT z dodatnią liczbą całkowitą (1 lub większą; LIMIT 0 jest nieprawidłowa). Łącząc to z kolejnością wyników, możesz tworzyć raporty „top N”, np. raport zawierający 5 kampanii z największą liczbą wyświetleń w ciągu ostatnich 30 dni:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
Filtruj wyniki
Łącząc filtry WHERE z ORDER BY i LIMIT, pamiętaj o tych ograniczeniach filtrowania:
- Filtrowanie segmentów bez ich wybierania jest niedozwolone, z wyjątkiem „podstawowych” pól segmentu daty (
segments.date,segments.week,segments.month,segments.quarterisegments.year). - Filtrowanie nie jest dozwolone w przypadku złożonych pól
MESSAGE(z wyjątkiem prostych komunikatów opakowujących, takich jakInt64ValueiStringValue); zamiast tego filtruj proste pola skalarne (int64,string,bool) lub podpola wyliczeniowe. - Filtrowanie nie jest dozwolone w przypadku złożonych atrybutów
MESSAGEpowtarzanych pól. Filtrować można tylko proste podpola skalarne (int64,string,bool), wyliczeniowe lub proste podpola opakowujące.