Explorador de la API de Google Ads

El Explorador de la API de Google Ads es un entorno de ejecución interactivo que te permite crear y enviar solicitudes a la API en tiempo real directamente desde tu navegador. Integrado en la documentación de referencia, controla las complejidades de la autenticación de OAuth 2.0 y el formato de cargas útiles JSON, lo que te permite probar servicios y métodos específicos sin escribir una sola línea de código.

Beneficios

  • Pruebas sin código: Ejecuta llamadas a la API en vivo (tanto de lectura como de escritura) directamente desde la documentación sin configurar un entorno de desarrollo local.
  • Descubrimiento de protocolos: Consulta la estructura exacta de las solicitudes y respuestas HTTP para comprender el comportamiento de la API.
  • Prototipos de baja fricción: Verifica el comportamiento del extremo y analiza las respuestas sin procesar de la API al instante antes de implementar la lógica en tu aplicación.
  • Autenticación simplificada: La herramienta administra los flujos de OAuth 2.0 automáticamente, lo que te permite enfocarte en la solicitud de la API en lugar de la administración de credenciales.

Cómo comenzar

  1. Navega a la documentación: Ve a la documentación de referencia y selecciona el servicio y el método que deseas probar, como GoogleAdsService/Search.
  2. Abre el Explorador: Busca el panel "Pruébalo" en el lado derecho de la página.
  3. Configura la solicitud:
    • Ingresa los parámetros de solicitud obligatorios, como developer-token y login-customer-id.
    • Define el cuerpo de la solicitud con el editor de JSON interactivo si el método requiere una carga útil, como para las operaciones `mutate`.
  4. Ejecutar: Haz clic en Ejecutar para enviar la solicitud. La herramienta mostrará la solicitud HTTP completa y la respuesta JSON en tiempo real de la API.

Características clave

  • Ejecución en vivo: Realiza operaciones de search y mutate en tiempo real en tus cuentas de producción o de prueba.
  • Formato de carga útil JSON: Crea de forma interactiva objetos JSON complejos para las solicitudes, con la herramienta que destaca los campos obligatorios y las estructuras de esquema válidas.
  • Máscaras de campo: Prueba una lógica de update_mask para ver cómo se comportan en la práctica las actualizaciones parciales de recursos.
  • Inspección de errores: Consulta los códigos y mensajes de error detallados (como QUERY_ERROR o AUTHENTICATION_ERROR) en la respuesta sin procesar para facilitar una depuración más rápida.
  • Exportación de código: Exporta comandos curl, solicitudes HTTP sin procesar o código JavaScript de muestra desde la vista expandida del Explorador de APIs.

Ejemplos de casos de uso

  • Audita la configuración de la cuenta: Recupera rápidamente la configuración o los metadatos a nivel de la cuenta ejecutando una solicitud get o search.
  • Prueba mutaciones: Verifica el éxito de la creación de una campaña o de la actualización del presupuesto antes de implementar el código en producción.
  • Depurar GAQL: Usa el Explorador para ejecutar una cadena del lenguaje de consulta de Google Ads (GAQL) y verificar que la estructura JSON que se devuelve coincida con las expectativas de tu aplicación.
  • Verificación de protocolo: Inspecciona los encabezados HTTP exactos y el anidamiento de JSON necesarios para una versión específica de la API.