El Compilador de consultas de Google Ads es una herramienta interactiva diseñada para ayudarte a crear y validar consultas con el lenguaje de consulta de Google Ads (GAQL). Ya sea que no conozcas GAQL o que seas 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.
- 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 de escritura, lo que garantiza que la búsqueda generada sea válida.
- Creación de consultas más rápida: Agiliza el proceso de desarrollo automatizando la generación de cadenas de consulta.
- Validación: La herramienta está vinculada al Explorador de APIs y al 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 en 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 se coloca 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 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 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: Agrega condiciones de cláusulas
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 y también se vincula al Explorador de APIs para que puedas probar tu consulta con los datos de tu cuenta. También hay un validador de consultas independiente en el que puedes pegar y verificar las consultas de GAQL escritas manualmente.
- Exportar: Cuando 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
Existen dos formas de acceder al Compilador de consultas: a través de una página específica en los documentos de referencia de informes o desde la página de descripción general del Compilador de consultas.
De 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 Compilador de consultas de la documentación de referencia de informes y selecciona el recurso que deseas explorar.
Integración con otras herramientas
El compilador 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 la consulta, haz clic en Probar en el Explorador de APIs para abrirla en el Explorador de APIs. Tu consulta se completa automáticamente en el cuerpo de la solicitud y, luego, puedes probarla ejecutándola en los datos de tu cuenta. Consulta el Explorador de APIs 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 consulta. Cualquier consulta creada por completo a través del Compilador de consultas ya tiene la sintaxis correcta, pero si conoces el recurso sobre el que realizas la consulta, el Validador de consultas proporciona 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.