Validador de consultas de Google Ads

El Validador de consultas de Google Ads es una herramienta interactiva diseñada para ayudar a los desarrolladores a crear y verificar consultas del lenguaje de consultas de Google Ads (GAQL) antes de integrarlas en las aplicaciones. Te permite ingresar una cadena de consulta de GAQL y recibir comentarios inmediatos sobre su validez, lo que ayuda a detectar errores de sintaxis, incompatibilidades de campos y otros problemas en las primeras etapas del proceso de desarrollo.

Beneficios

  • Prevención de errores: Detecta las búsquedas no válidas de forma anticipada, antes de que se integren en las aplicaciones, lo que reduce los errores de tiempo de ejecución y las fallas en las llamadas a la API.
  • Desarrollo más rápido: Permite realizar pruebas y depuraciones rápidas de las sentencias de GAQL sin la sobrecarga de los ciclos completos de solicitud y respuesta de la API.
  • Comprensión de las restricciones de GAQL: Ayuda a los desarrolladores a conocer las reglas complejas sobre qué campos son compatibles y cómo se relacionan los recursos entre sí.
  • Depuración de consultas: Proporciona mensajes de error específicos cuando una consulta no es válida, que suelen ser más detallados que un error genérico de la API y, a veces, sugieren alternativas válidas.
  • Eficiencia de recursos: Evita llamadas innecesarias a la API con búsquedas que están destinadas a fallar.

Cómo funciona

El Validador de consultas analiza tu consulta de GAQL en función del esquema de la API de Google Ads y las reglas definidas en el lenguaje de consultas de Google Ads. Utiliza metadatos, muchos de los cuales son accesibles desde GoogleAdsFieldService, para realizar verificaciones, como las siguientes:

  1. Sintaxis y estructura: Garantiza que la consulta siga la gramática correcta de GAQL, incluido el uso y el orden adecuados de las cláusulas como SELECT, FROM, WHERE, ORDER BY y LIMIT.
  2. Validez de los campos: Verifica si todos los campos especificados (recursos, segmentos, métricas) existen y están escritos correctamente.
  3. Compatibilidad de recursos: Verifica que los campos seleccionados en la cláusula SELECT sean compatibles con el recurso principal especificado en la cláusula FROM.
  4. Compatibilidad de segmentos y métricas: Garantiza que los segmentos y las métricas que se usan juntos en la misma consulta sean compatibles entre sí y con el recurso de la cláusula FROM.
  5. Requisitos de cláusulas: Valida reglas, como el requisito de que ciertos campos utilizados en las cláusulas WHERE o ORDER BY también estén presentes en la cláusula SELECT.
  6. Uso de operadores: Verifica el uso correcto de los operadores dentro de las condiciones de la cláusula WHERE.

Si la búsqueda es válida, la herramienta lo confirma. Si se encuentran problemas, se proporcionan mensajes de error diseñados para ayudar a identificar el problema y, a veces, se ofrecen sugerencias para corregirlo, como recursos compatibles para una métrica determinada.

Comenzar

Para usar el Validador de consultas de Google Ads, sigue estos pasos:

  1. Navega al Validador de consultas.
  2. Ingresa tu consulta de GAQL.
  3. Haz clic en el botón Validar consulta.
  4. Revisa el mensaje de validación que aparece debajo del widget del validador de consultas. Un mensaje de éxito indica que la consulta es válida. De lo contrario, se mostrará un mensaje de error que describa el problema. Los mensajes de error te guiarán para corregir la consulta. Por ejemplo, un error de incompatibilidad de campos puede enumerar recursos alternativos que *sí* son compatibles con la métrica o el segmento que intentas consultar.

Para obtener explicaciones más detalladas sobre los conceptos y la validación de GAQL, también puedes consultar las guías en video de GAQL.