Валидатор запросов Google Рекламы

Валидатор запросов Google Рекламы – это интерактивный инструмент, который помогает разработчикам создавать и проверять запросы на языке GAQL перед их интеграцией в приложения. Вы можете ввести строку запроса GAQL и сразу же получить информацию о ее корректности. Это позволяет выявлять синтаксические ошибки, несовместимость полей и другие проблемы на ранних этапах разработки.

Преимущества

  • Предотвращение ошибок. Выявляет недействительные запросы до того, как они будут интегрированы в приложения, что снижает количество ошибок выполнения и сбоев вызовов API.
  • Ускоренная разработка. Позволяет быстро тестировать и отлаживать запросы GAQL без необходимости выполнять полные циклы запросов к API и ответов.
  • Понимание ограничений GAQL. Помогает разработчикам изучить сложные правила, касающиеся совместимости полей и взаимосвязи ресурсов.
  • Отладка запросов. Если запрос недействителен, вы увидите сообщение об ошибке. Обычно оно более подробное, чем стандартное сообщение об ошибке API, и иногда содержит рекомендации по исправлению.
  • Эффективность использования ресурсов. Позволяет избежать ненужных вызовов API с запросами, которые не будут выполнены.

Принцип работы

Валидатор запросов анализирует ваш запрос GAQL на соответствие схеме Google Ads API и правилам, определенным в языке запросов Google Рекламы. Для этого используются метаданные, многие из которых доступны в GoogleAdsFieldService. В частности, выполняются следующие проверки:

  1. Синтаксис и структура. Проверяет, соответствует ли запрос правилам грамматики GAQL, включая правильное использование и порядок таких операторов, как SELECT, FROM, WHERE, ORDER BY, LIMIT и PARAMETERS.
  2. Действительность полей. Проверяется, существуют ли все указанные поля (ресурсы, сегменты, показатели) и правильно ли они написаны.
  3. Совместимость ресурсов. Проверяет, совместимы ли поля, выбранные в условии SELECT, с основным ресурсом, указанным в условии FROM.
  4. Совместимость сегментов и показателей. Сегменты и показатели, используемые в одном запросе, должны быть совместимы друг с другом и с ресурсом в условии FROM.
  5. Требования к условиям. Проверяются правила, например требование о том, что поля, используемые в условиях ORDER BY, и некоторые поля, используемые в условиях WHERE (например, сегменты), также должны присутствовать в условии SELECT.
  6. Использование операторов. Проверяется правильность использования операторов в условиях предложения WHERE.

Если запрос действителен, инструмент подтвердит это. Если будут обнаружены проблемы, вы увидите сообщения об ошибках, которые помогут вам определить причину неполадок. Иногда в таких сообщениях предлагаются решения, например совместимые ресурсы для определенного показателя.

Начать

Чтобы использовать валидатор запросов Google Ads API, выполните следующие действия:

  1. Перейдите в Валидатор запросов.
  2. Введите запрос GAQL.
  3. Нажмите кнопку Проверить запрос.
  4. Ознакомьтесь с сообщением о проверке, которое появится под виджетом. Если запрос действителен, появится сообщение об успешном выполнении. В противном случае появится сообщение об ошибке. Сообщения об ошибках помогут вам исправить запрос. Например, в сообщении об ошибке несовместимости полей могут быть перечислены альтернативные ресурсы, которые совместимы с показателем или сегментом, который вы пытаетесь запросить.

Подробные объяснения концепций и синтаксиса GAQL можно найти в руководстве по языку запросов Google Ads API. Для интерактивного создания и тестирования запросов GAQL вы также можете использовать конструктор запросов и API Explorer.