Упорядочение и ограничение результатов

Результаты заказа

Вы можете указать порядок строк в своем ответе, используя предложение ORDER BY , которое состоит из одной или нескольких последовательностей, разделенных запятыми:

FieldName ('ASC' | 'DESC')?

Если вы не укажете ASC или DESC после имени поля, API Google Рекламы по умолчанию будет использовать значение ASC .

Следующее предложение ORDER BY сортирует отчет на уровне кампании по убыванию количества показов и возрастанию названия кампании:

ORDER BY metrics.impressions DESC, campaign.name ASC

Заказ не допускается:

  • По атрибутам невыбранных ресурсов
  • По невыбранным метрикам
  • По невыбранным сегментам
  • Для полей следующих типов:
    • MESSAGE
    • Повторяющиеся поля
    • Атрибуты повторяющихся полей

Ограничение количества результатов

Вы можете ограничить общее количество возвращаемых результатов с помощью предложения LIMIT . Объединив это с упорядочиванием результатов, вы можете создать отчеты «top N», например отчет, содержащий пять кампаний с наибольшим количеством показов за последние 30 дней:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Фильтрация не допускается:

  • По сегментам без их выделения, за исключением «основных» полей сегмента даты.
    • Основные поля сегмента даты — это segments.date , segments.week , segments.month , segments.quarter и segments.year .
  • В полях любого типа сообщения, кроме примитивов (например: Int64Value, StringValue и т. д.)
  • По атрибутам повторяющихся полей любого типа сообщения, кроме примитивов (например: Int64Value, StringValue и т. д.)