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