Sortowanie i ograniczanie wyników

Zamawianie wyników

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

FieldName ('ASC' | 'DESC')?

Jeśli po nazwie pola nie podasz wartości ASC ani DESC, interfejs Google Ads API zastosuje domyślnie wartość ASC.

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

Nie można zamówić:

  • Według atrybutów niezaznaczonych 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, używając klauzuli LIMIT. Połączenie tego z sortowaniem wyników pozwala tworzyć raporty „najlepszych 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

Filtrowanie jest niedozwolone:

  • w segmentach bez ich zaznaczania, z wyjątkiem pól „rdzenia” segmentu dat,
    • Podstawowe pola segmentu daty to segments.date, segments.week, segments.month, segments.quarter i segments.year.
  • W polach wiadomości dowolnego typu z wyjątkiem typów prymitywnych (np. Int64Value, StringValue itp.).
  • W atrybutach pól powtarzanych dowolnego typu wiadomości oprócz typów prymitywnych (np. Int64Value, StringValue itp.).