Zamawianie i ograniczanie wyników

Język zapytań Google Ads umożliwia sortowanie i ograniczanie liczby wierszy zwracanych w odpowiedziach na zapytania za pomocą klauzul ORDER BY i LIMIT.

Sortowanie wyników

Kolejność wierszy w odpowiedzi możesz określić za pomocą klauzuli ORDER BY, która składa się z co najmniej 1 rozdzielonej przecinkami sekwencji:

FieldName (ASC | DESC)?

Jeśli po nazwie pola nie określisz ASC ani DESC, interfejs Google Ads API domyślnie użyje ASC. Jeśli całkowicie pominiesz klauzulę ORDER BY, kolejność zwracanych wierszy będzie niedeterministyczna.

Ta 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łowe). Łącząc to z sortowaniem wyników, możesz tworzyć raporty „N najpopularniejszych”, 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

Filtrowanie wyników

Łącząc filtry WHERE z klauzulami ORDER BY i LIMIT, pamiętaj o tych ograniczeniach filtrowania:

  • Filtrowanie nie jest dozwolone w przypadku segmentów bez ich wybrania, z wyjątkiem pól segmentu daty „podstawowej” (segments.date, segments.week, segments.month, segments.quarter i segments.year).
  • Filtrowanie nie jest dozwolone bezpośrednio w przypadku pól złożonych MESSAGE (z wyjątkiem prostych komunikatów opakowujących, takich jak Int64Value i StringValue); zamiast tego filtruj według ich prostych pól skalarnych (int64, string, bool) lub podrzędnych pól wyliczeniowych.
  • Filtrowanie nie jest dozwolone w przypadku złożonych atrybutów MESSAGE pól powtarzanych; można filtrować tylko proste pola skalarne (int64, string, bool), wyliczeniowe lub proste pola opakowujące.
Wstecz
Rozróżnianie wielkości liter