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 vivo directamente desde tu navegador. Integrado en la documentación de referencia, maneja las complejidades de la autenticación de OAuth 2.0 y el formato de carga útil de 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 examina las respuestas sin procesar de la API de forma instantánea antes de implementar la lógica en tu aplicación.
  • Autenticación simplificada: La herramienta administra automáticamente los flujos de OAuth 2.0, lo que te permite enfocarte en la solicitud a 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. Ejecuta: Haz clic en Ejecutar para enviar la solicitud. La herramienta mostrará la solicitud HTTP completa y la respuesta JSON en vivo de la API.

Características clave

  • Ejecución en vivo: Realiza operaciones search y mutate en tiempo real en tus cuentas de producción o de prueba.
  • Formato de carga útil de JSON: Crea de forma interactiva objetos JSON complejos para las solicitudes. La herramienta destaca los campos obligatorios y las estructuras de esquema válidas.
  • Máscaras de campo: Prueba una lógica 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 la depuración más rápida.
  • Exportación de código: Exporta comandos curl, solicitudes HTTP sin procesar o código de muestra de JavaScript desde la vista expandida del Explorador de API.

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 la actualización del presupuesto antes de implementar el código en producción.
  • Depura GAQL: Usa el Explorador para ejecutar una cadena del lenguaje de consulta de Google Ads (GAQL) y verifica que la estructura JSON que se muestra coincida con las expectativas de tu aplicación.
  • Verificación de protocolos: Inspecciona los encabezados HTTP exactos y el anidamiento de JSON necesarios para una versión específica de la API.