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 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 las consultas no válidas en las primeras etapas, antes de que se integren en las aplicaciones, lo que reduce los errores de tiempo de ejecución y las fallas de llamadas a la API.
  • Desarrollo más rápido: Permite realizar pruebas y depuraciones rápidas de las instrucciones de GAQL sin la sobrecarga de los ciclos completos de solicitud a la API y respuesta.
  • Comprensión de las restricciones de GAQL: Ayuda a los desarrolladores a aprender 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 innecesarias a la API 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, gran parte de los cuales son accesibles desde GoogleAdsFieldService, para realizar verificaciones, 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 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 las cláusulas: Valida reglas como el requisito de que ciertos campos que se usan 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 consulta es válida, la herramienta lo confirma. Si se encuentran problemas, proporciona mensajes de error diseñados para ayudar a identificar el problema y, a veces, ofrece sugerencias para corregirlos, como recursos compatibles para una métrica determinada.

Comenzar

Para usar el Validador de consultas de Google Ads, haz lo siguiente:

  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 muestra 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 podría mostrar una lista de recursos alternativos que *sí* sean 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.