Конструктор запросов 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 .
Валидатор запросов
При нажатии кнопки «Ввести» или «Редактировать запрос» открывается валидатор запросов. Используйте валидатор запросов для проверки синтаксиса вашего запроса. Любой запрос, полностью созданный с помощью конструктора запросов, уже будет иметь правильный синтаксис, но если вы знакомы с ресурсом, к которому обращаетесь, валидатор запросов предоставит быстрый способ ввести запрос и проверить его корректность. См. раздел «Валидатор запросов» для получения дополнительной информации об этом инструменте.