Параметры запроса Google Ads

Запросы к Google Ads API формируются с использованием Google Ads Query Language (GAQL). Ниже описаны основные параметры и конструкции языка.

Параметры SELECT

Основные поля

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros

Псевдонимы (алиасы)

SELECT
  campaign.id AS campaign_id,
  campaign.name AS campaign_name,
  metrics.cost_micros AS cost

Функции агрегации

SELECT
  campaign.id,
  SUM(metrics.impressions) AS total_impressions,
  AVG(metrics.ctr) AS avg_ctr

Параметры FROM

Ресурс, из которого запрашиваются данные:

Ресурс	Описание
campaign	Кампании
ad_group	Группы объявлений
ad_group_ad	Объявления
keyword_view	Ключевые слова
search_term_view	Поисковые запросы
customer	Аккаунт

Параметры WHERE

Фильтрация по значению

WHERE campaign.status = 'ENABLED'
  AND metrics.impressions > 100

Фильтрация по дате (DURING)

WHERE segments.date DURING LAST_30_DAYS
WHERE segments.date DURING LAST_7_DAYS
WHERE segments.date BETWEEN '2026-07-01' AND '2026-07-25'

Операторы

Оператор	Пример
=	status = 'ENABLED'
!=	type != 'VIDEO'
>	impressions > 100
<	cost_micros < 5000000
>=	clicks >= 10
<=	ctr <= 0.05
IN	status IN ('ENABLED', 'PAUSED')
NOT IN	type NOT IN ('VIDEO', 'DISPLAY')
LIKE	name LIKE '%brand%'
NOT LIKE	name NOT LIKE '%test%'

Параметры ORDER BY

ORDER BY metrics.cost_micros DESC
ORDER BY campaign.name ASC, metrics.clicks DESC

Параметры LIMIT

LIMIT 100
LIMIT 1000

Максимальный лимит: 10 000 строк на один запрос.

Параметры пагинации

Для запросов с более чем 10 000 строк используется page_token:

POST /customers/{customer_id}/googleAds:search
{
  "query": "SELECT ...",
  "page_token": "abc123",
  "page_size": 10000
}

Сегментация (Segments)

Сегментация позволяет разбить данные по дополнительным измерениям:

SELECT
  campaign.name,
  segments.device,
  segments.date,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Основные сегменты

Сегмент	Описание
segments.date	По дням
segments.week	По неделям
segments.month	По месяцам
segments.quarter	По кварталам
segments.device	По устройствам (DESKTOP, MOBILE, TABLET)
segments.network	По рекламным сетям
segments.day_of_week	По дням недели
segments.hour	По часам

Связанные страницы

• Метрики
• Сегменты
• Фильтры
• Дата и время