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 no tengas experiencia con GAQL o que seas un usuario experimentado, el Compilador de consultas puede simplificar el proceso de obtención de los datos exactos que necesitas de la API de Google Ads.
Beneficios
- Facilidad de uso: Simplifica el proceso de escritura de consultas de GAQL sin requerir familiaridad con la sintaxis específica y los campos disponibles.
- Capacidad de descubrimiento: Ayuda a explorar y encontrar recursos, campos, segmentos y métricas disponibles dentro del 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 consulta generada sea válida.
- Compilación de consultas más rápida: Acelera el proceso de desarrollo mediante la automatización de la generación de cadenas de consulta.
- Validación: La herramienta está vinculada al Explorador de API y al Validador de consultas para verificar las consultas en función de 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 consultas de GAQL. Este es el flujo de trabajo básico:
- Selecciona un recurso: Para comenzar, elige el recurso principal en la
pestaña Referencia de 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 muestra todos los recursos disponibles. - Elige campos: Una vez que se selecciona un recurso, la herramienta muestra todos los campos seleccionables, 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 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. - Aplica 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. - Ordena los 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 muestran. - Valida: La herramienta te guía de forma inherente hacia combinaciones de campos válidas, pero también se vincula al Explorador de APIs para que puedas probar tu consulta en función de los datos de tu cuenta. También hay un [Validador de consultas](link to page) independiente en el que puedes pegar y verificar las consultas de GAQL escritas manualmente.
- Exporta: Una vez que estés conforme con tu consulta, copia y pega la cadena de GAQL probada y con sintaxis correcta en tus solicitudes de cliente
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 ir a una página específica en los documentos de referencia de informes, y la otra es explorar desde la página de descripción general del Compilador de consultas.
Desde los documentos 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. Como alternativa, navega 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 Compilador de consultas de los documentos de referencia de informes y selecciona el recurso que deseas explorar.
Integración con otras herramientas
El Compilador de consultas está integrado con otras herramientas en el 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 API o validarla con el Validador de consultas.
Explorador de API
Una vez que hayas creado tu consulta, haz clic en Probar en el Explorador de API para abrirla en el Explorador de API. Tu consulta se propagará automáticamente en el cuerpo de la solicitud y, luego, podrás probarla ejecutándola en función de 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 Ingresar o editar una consulta, se abre el Validador de consultas. Usa el Validador de consultas para validar la sintaxis de tu consulta. Cualquier consulta creada por completo a través del Compilador de consultas ya tendrá la sintaxis correcta, pero si estás familiarizado con el recurso que estás consultando, el Validador de consultas proporcionará una forma rápida de ingresar una consulta y verificar su validez. Consulta Validador de consultas para obtener más información sobre esa herramienta.