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. Integrada en la documentación de referencia, controla las complejidades de la autenticación de OAuth 2.0 y el formato de la carga útil 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 inmediatamente 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 a la API en lugar de la administración de credenciales.
Comenzar
- 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. - Abre el Explorador: Busca el panel Try this method en el lado derecho de la página.
- Configura la solicitud:
- Ingresa los parámetros de solicitud obligatorios, como
customerId, y expande Encabezados para proporcionar encabezados HTTP opcionales, comologin-customer-id(obligatorio solo cuando se accede a una cuenta a través de una cuenta de administrador). Ten en cuenta que los tokens de desarrollador (developer-token) se dieron de baja el 9 de septiembre de 2026 y los servidores de la API los ignoran, aunque puedes ingresar un valor si el formulario te lo solicita. - Define el cuerpo de la solicitud con el editor de JSON interactivo si el método requiere una carga útil, como para las operaciones
searchomutate.
- Ingresa los parámetros de solicitud obligatorios, como
- Ejecutar: Haz clic en Ejecutar para enviar la solicitud. La herramienta muestra la solicitud HTTP completa y la respuesta JSON en tiempo real de la API.
Características clave
- Ejecución en vivo: Realiza operaciones de
searchymutateen tiempo real en tus cuentas de producción o de prueba. - Formato de carga útil JSON: Crea de forma interactiva objetos JSON complejos para solicitudes, con la herramienta que destaca los campos obligatorios y las estructuras de esquema válidas.
- Máscaras de campo: Prueba la lógica de
update_maskpara ver cómo se comportan en la práctica las actualizaciones parciales de recursos. - Inspección de errores: Consulta los mensajes y códigos de error detallados (como
QUERY_ERRORoAUTHENTICATION_ERROR) en la respuesta sin procesar para facilitar una depuración más rápida. - Exportación de código: Exporta comandos de
curl, solicitudes HTTP sin procesar o código JavaScript de muestra desde la vista expandida del Explorador de APIs.
Ejemplos de casos de uso
- Auditar la configuración de la cuenta: Recupera rápidamente la configuración o los metadatos a nivel de la cuenta ejecutando una solicitud
GoogleAdsService/Searchen el recursocustomer. - 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.
- Depura 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.