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, controla las complejidades de la autenticación de OAuth 2.0 y el formato de la 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.
- Detección de protocolos: Consulta la estructura exacta de las solicitudes HTTP y las respuestas para comprender cómo se comporta la API.
- Creación de prototipos con poca fricción: Verifica el comportamiento de los extremos y, luego, inspecciona las respuestas de la API sin procesar 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 Probar este método 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(solo se requiere cuando se accede a una cuenta a través de una cuenta de administrador). Ten en cuenta que los tokens de desarrollador (developer-token) dejaron de estar disponibles el 9 de septiembre de 2026 y los servidores de la API los ignoran, aunque puedes ingresar un valor si el formulario 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 vivo de la API.
Características clave
- Ejecución en vivo: Realiza operaciones
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 las 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 las actualizaciones parciales de recursos en la práctica. - Inspección de errores: Consulta los mensajes de error y códigos 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 de 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 las configuraciones o los metadatos a nivel de la cuenta ejecutando una solicitud
GoogleAdsService/Searchen el recursocustomer. - Prueba las mutaciones: Verifica que la creación de una campaña o la actualización de un presupuesto se hayan realizado correctamente antes de implementar el código en producción.
- Depura el GAQL: Usa el Explorador para ejecutar una cadena del lenguaje de consulta de Google Ads (GAQL) y verificar que la estructura JSON que se muestra 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.