Конструктор запросов 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…
Валидатор запросов
Когда вы нажмете Введите или измените запрос, откроется валидатор запросов. Для проверки синтаксиса запроса используйте валидатор запросов. Любой запрос, созданный в Редакторе запросов, имеет правильный синтаксис. Однако если вы хорошо знакомы с ресурсом, к которому обращаетесь, то можете быстро ввести запрос и проверить его правильность с помощью Валидатора запросов. Подробнее о валидаторе запросов…