Конструктор запросов Google Рекламы – это интерактивный инструмент, который помогает создавать и проверять запросы на языке GAQL. Независимо от того, насколько хорошо вы знакомы с GAQL, конструктор запросов поможет вам получать из Google Ads API именно те данные, которые вам нужны.
Преимущества
- Простота использования. Упрощает процесс написания запросов GAQL, не требуя знания конкретного синтаксиса и доступных полей.
- Обнаруживаемость. Помогает находить доступные ресурсы, поля, сегменты и показатели в модели данных Google Ads API.
- Меньше ошибок. Структурированный интерфейс и раскрывающиеся меню с допустимыми вариантами помогают избежать синтаксических ошибок и опечаток, чтобы сгенерированный запрос был действительным.
- Ускоренное создание запросов. Автоматизация создания строк запросов ускоряет процесс разработки.
- Проверка. Инструмент связан с API Explorer и Query Validator, что позволяет проверять запросы на соответствие правилам API перед выполнением.
Принцип работы
Конструктор запросов Google Рекламы – это удобный интерфейс для визуального создания запросов GAQL. Вот как это делается:
- Выберите ресурс. Начните с выбора основного ресурса на вкладке Справочник для версии, к которой вы хотите отправить запрос. Этот ресурс размещается в пункте
FROM. Ресурсы представляют собой объекты в Google Рекламе, напримерcampaign,ad_groupилиkeyword_view. В конструкторе перечислены все доступные ресурсы. - Выбор полей. После выбора ресурса инструмент показывает все доступные поля, включая атрибуты, сегменты и показатели, связанные с этим ресурсом и его атрибутированными (неявно объединяемыми) ресурсами. Вы можете установить флажки, чтобы включить поля в предложение
SELECT. По мере того как вы выбираете нужные параметры, инструмент динамически генерирует соответствующую строку запроса GAQL, показывает ошибки и отфильтровывает несовместимые комбинации полей. - Примените фильтры. Добавьте условия
WHERE, чтобы отфильтровать результаты. Конструктор помогает выбрать поля, операторы и значения, обеспечивая правильный синтаксис. - Сортировка результатов. Задайте порядок сортировки с помощью оператора
ORDER BY. - Установите ограничения. Добавьте условие
LIMIT, чтобы ограничить количество возвращаемых результатов. - Проверка. Инструмент помогает выбрать допустимые комбинации полей и содержит ссылку на API Explorer, где можно протестировать запрос с данными в аккаунте. Также есть отдельный валидатор запросов, в который можно вставить и проверить написанные вручную запросы GAQL.
- Экспорт. Когда вы будете удовлетворены результатом, скопируйте и вставьте проверенную и синтаксически правильную строку GAQL в клиентские запросы
GoogleAdsService.SearchилиSearchStream.
Конструктор проверяет, совместимы ли выбранные поля, сегменты и показатели и можно ли их использовать вместе в одном запросе, ссылаясь на базовые метаданные Google Ads API.
Начать
Перейти к конструктору запросов можно двумя способами: через определенную страницу в справочной документации по отчетам или через обзорную страницу конструктора запросов.
Из справочной документации по отчетам
- Начните со справочной документации по отчетам и выберите ресурс в списке всех ресурсов. Вы также можете перейти к ресурсу напрямую с помощью панели навигации слева.
- Нажмите Помочь составить запрос, чтобы перейти в конструктор запросов для этого ресурса.
На обзорной странице конструктора запросов
Перейдите в раздел Конструктор запросов справочной документации по отчетам и выберите нужный ресурс.
Интеграция с другими инструментами
Конструктор запросов интегрирован с другими инструментами в наборе инструментов разработчика Google Ads API. Запрос, созданный в конструкторе запросов, можно протестировать в API Explorer или проверить с помощью валидатора запросов.
API Explorer
После того как вы создали запрос, нажмите Попробовать в API Explorer, чтобы открыть запрос в API Explorer. Ваш запрос автоматически подставится в тело запроса, и вы сможете протестировать его, выполнив в своих данных в аккаунте. Подробнее об API Explorer…
Валидатор запросов
Если нажать Введите или измените запрос, откроется валидатор запросов. Для проверки синтаксиса запроса используйте валидатор запросов. Любой запрос, созданный полностью в конструкторе запросов, уже имеет правильный синтаксис. Но если вы знакомы с ресурсом, к которому обращаетесь, валидатор запросов позволяет быстро ввести запрос и проверить его правильность. Подробнее о валидаторе запросов…