El Compilador de consultas de Google Ads es una herramienta interactiva diseñada para ayudarte a crear y validar consultas de forma interactiva con el lenguaje de consulta de Google Ads (GAQL). Ya sea que seas nuevo en GAQL o un usuario experimentado, el Compilador de consultas puede simplificar el proceso de recuperación de los datos exactos que necesitas de la API de Google Ads.
Beneficios
- Facilidad de uso: Simplifica el proceso de escritura de consultas en GAQL, sin necesidad de conocer la sintaxis específica ni los campos disponibles.
- Capacidad de descubrimiento: Ayuda a explorar y encontrar los recursos, los campos, los segmentos y las métricas disponibles en el modelo de datos de la API de Google Ads.
- Reducción de errores: Al proporcionar una interfaz estructurada y menús desplegables de opciones válidas, ayuda a evitar errores de sintaxis y errores tipográficos, lo que garantiza que la búsqueda generada sea válida.
- Creación de consultas más rápida: Acelera el proceso de desarrollo automatizando la generación de cadenas de consulta.
- Validación: La herramienta está vinculada con el Explorador de API y el Validador de consultas para verificar las consultas según las reglas de la API antes de la ejecución.
Cómo funciona
El compilador de consultas de Google Ads proporciona una interfaz fácil de usar para ensamblar visualmente las consultas de GAQL. Este es el flujo de trabajo básico:
- Selecciona un recurso: Comienza por elegir el recurso principal en la pestaña Referencia para la versión que deseas consultar. Este recurso estará en la cláusula
FROM. Los recursos representan entidades dentro de Google Ads, comocampaign,ad_groupokeyword_view. El compilador enumera todos los recursos disponibles. - Elige campos: Una vez que se selecciona un recurso, la herramienta muestra todos los campos que se pueden seleccionar, incluidos los atributos, los segmentos y las métricas relacionados con ese recurso y sus recursos atribuidos (que se pueden unir de forma implícita). Puedes marcar las casillas de verificación para incluir campos en tu cláusula
SELECT. A medida que realizas selecciones, la herramienta genera de forma dinámica la cadena de consulta de GAQL correspondiente, muestra los errores y filtra las combinaciones de campos incompatibles. - Aplicar filtros: Puedes agregar condiciones de cláusula
WHEREpara filtrar los resultados. El compilador te ayuda a elegir campos, operadores y valores, lo que garantiza una sintaxis correcta. - Ordenar resultados: Especifica los órdenes de clasificación con la cláusula
ORDER BY. - Establece límites: Agrega una cláusula
LIMITpara controlar la cantidad de resultados que se devuelven. - Validar: La herramienta te guía de forma inherente hacia combinaciones de campos válidas, pero también se vincula al Explorador de API para que puedas probar tu consulta con los datos de tu cuenta. También hay un [Validador de consultas](vínculo a la página) independiente en el que puedes pegar y verificar manualmente las consultas escritas en GAQL.
- Exportar: Una vez que estés conforme con tu consulta, copia y pega tu cadena de GAQL probada y sintácticamente correcta en tus solicitudes de cliente de
GoogleAdsService.SearchoSearchStream.
El compilador garantiza que los campos, los segmentos y las métricas seleccionados sean compatibles y se puedan usar juntos en una sola consulta, haciendo referencia a los metadatos subyacentes de la API de Google Ads.
Comenzar
Hay dos formas de acceder al compilador de consultas. Una opción es consultar una página específica en la documentación de referencia de informes, y la otra es explorar desde la página de descripción general del Creador de consultas.
Desde la documentación de referencia de informes
- Comienza con los documentos de referencia de informes y elige un recurso específico para comenzar en la lista de todos los recursos. También puedes navegar directamente al recurso desde el panel de navegación de la izquierda.
- Haz clic en Ayúdame a crear una consulta, que te llevará al Compilador de consultas para ese recurso específico.
Desde la página de descripción general del Compilador de consultas
Ve a la sección Generador de consultas de la documentación de referencia de informes y selecciona el recurso que deseas explorar.
Integración con otras herramientas
El Generador de consultas está integrado en otras herramientas del kit de herramientas para desarrolladores de la API de Google Ads. Puedes tomar una consulta creada en el compilador de consultas y probarla en el Explorador de APIs o validarla con el validador de consultas.
Explorador de API
Una vez que hayas creado tu consulta, haz clic en Pruébalo en el Explorador de API para abrirla en el Explorador de API. Tu consulta se completará automáticamente en el cuerpo de la solicitud y, luego, podrás probarla ejecutándola en los datos de tu cuenta. Consulta Explorador de API para obtener más información sobre esa herramienta.
Validador de consultas
Cuando haces clic en Ingresa o edita una consulta, se abre el Validador de consultas. Usa el validador de consultas para validar la sintaxis de tu búsqueda. Cualquier consulta creada por completo a través del Generador de consultas ya tendrá la sintaxis correcta, pero si conoces el recurso sobre el que realizas la consulta, el Validador de consultas te proporcionará una forma rápida de ingresar una consulta y verificar su validez. Consulta el Validador de consultas para obtener más información sobre esa herramienta.