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 en el lenguaje de consulta 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 consultas 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 probar y depurar con rapidez las declaraciones de GAQL sin la sobrecarga de los ciclos completos de solicitud y respuesta a la API.
  • Información sobre 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, sugiere alternativas válidas.
  • Eficiencia de los recursos: Evita las llamadas a la API innecesarias con consultas 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 consulta de Google Ads. Usa metadatos, muchos de los cuales son accesibles desde GoogleAdsFieldService, para realizar comprobaciones, incluidas 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 cláusulas como SELECT, FROM, WHERE, ORDER BY, LIMIT y PARAMETERS.
  2. Validez de los campos: Verifica si todos los campos especificados (recursos, segmentos y 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 los campos que se usan en las cláusulas ORDER BY y ciertos campos que se usan en las cláusulas WHERE (como los segmentos) 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 consulta 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 de correcciones, 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 describe el problema. Los mensajes de error te guían para corregir la consulta. Por ejemplo, un error de incompatibilidad de campos puede incluir una lista de recursos alternativos que son compatibles con la métrica o el segmento que intentas consultar.

Para obtener explicaciones más detalladas de los conceptos y la sintaxis del GAQL, consulta la guía del lenguaje de consulta de Google Ads. Para compilar y probar consultas de GAQL de forma interactiva, también puedes usar el Compilador de consultas y el Explorador de APIs.