En este artículo se explica cómo utilizar el Informe API v2. En 2025, presentamos la nueva versión de nuestro generador de informes. El Informe API v2 proporciona acceso a todos los datos y funcionalidades del nuevo generador de informes.

El Informe API v2 sustituye al Informe personalizado API v1. Si usas la versión antigua, te enviaremos un correo electrónico detallado del periodo de transición y la fecha de eliminación planificada.
 

Antes de empezar

Para completar la configuración, necesitas permisos de Administrador. También puedes necesitar ayuda de tu departamento de informática o equipo de integraciones.

Entender el paso a la v2

El nuevo Informe API v2 coincide con las capacidades de la versión anterior e incluye mejoras. Al igual que antes, puedes consultar los informes uno por uno utilizando el ID del informe.

Esto es lo nuevo de v2:

• Es más rápido y eficiente en el manejo de grandes conjuntos de datos.
• Puedes seleccionar explícitamente qué informes están disponibles mediante API mediante un nuevo menú desplegable. Ten en cuenta que solo los Administradores pueden seleccionar informes para acceder API.
• Hay visibilidad y control mejorados para los Administradores a través de una nueva lista de informes API, incluso si no eres el propietario de un informe. Aún así, solo puedes abrir los informes compartidos contigo o de tu propiedad.
• Los informes personalizados históricos ahora incluyen nombre y apellidos. No es necesario obtener esta información por separado utilizando la API empleado. La v2 muestra los datos exactos que se ven en la IU.
• Ayuda mejorada para filtros (anteriormente, solo ES o NO ES era posible).

Ten en cuenta lo siguiente:

• Planeamos retirar la API de Informes personalizados v1. Te informaremos de los plazos de tiempo exactos por correo electrónico.
• Próximamente se presentarán más funciones, incluidas consultas de datos sin procesar y crear / actualización / eliminar puntos finales para administrar informes mediante API.

Paso 1: Actualización de tu integración personalizada o construir una nueva

Para utilizar el Informe API v2, necesitas la actualización de tu integración personalizada activa o construir una nueva.

Actualización de tu integración personalizada

Cuando actualices la integración, podrás seguir usando las credenciales de API existentes.

Sigue estos pasos:

1. Ve a Ajustes > Seguridad e integraciones > Credenciales de la API.
2. Selecciona la integración personalizada pertinente y activa el acceso de Lectura para los Informes.
3. Para terminar, haz clic en Update.
4. La nueva API de Informe ya está habilitada, y puedes hacer informes disponibles.

Crea una nueva integración personalizada

Consulta nuestro artículo dedicado Centro de Ayuda para evaluar los requisitos para construir una integración personalizada.

1. Ve a Ajustes > Seguridad e integraciones > Credenciales de la API.
2. Haz clic en Crear integración personalizada
3. Asegúrate de activar el acceso de Lectura para Informes.
4. Consulta el Centro de desarrollo para obtener instrucciones sobre cómo configurar una integración personalizada.

Paso 2: Poner a disposición los informes vía API en el área de Análisis

Necesitas evaluar y activar los informes disponibles para la API. Si no aparece el botón Gestionar acceso a la API, vuelve al paso 1 y actualiza la integración. El botón solo estará disponible una vez que se haya guardado la integración con la API de informes v2 activada.

Así es como funciona:

• Los Informes personalizados siguen disponibles a través de la API v1 de Informes personalizados. No puedes deshabilitar el acceso a estos.
• Los informes que crees con el nuevo generador de informes están disponibles a través de la API Informe v2.

Solo puedes ver los informes compartidos contigo o que sean de tu propiedad. Evalúa la lista de informes y activa los informes que deseas poner a disposición de la API. 

Sigue estos pasos:

1. Ve a Análisis > Informes.
2. Marca la casilla junto al informe correspondiente.
3. Haz clic en Gestionar acceso API.
4. En el desplegable, selecciona Habilitado.
5. Guarda los cambios.

Paso 3: Actualización y realizar los cambios necesarios en tu integración API

Para actualización y realizar los cambios necesarios en tu integración API, sigue estos pasos:

1. Ajusta tu código de integración para utilizar los nuevos endpoints API v2 del informe para los informes habilitados.
2. Actualización de tus solicitudes API y autenticación para incluir "Acceso de lectura para informes".
3. Prueba tu integración para verificar que recibes los datos esperados del informe.

Para obtener detalles técnicos y ver consultas de ejemplo, visita el Centro de desarrolladores y revisa la documentación del Informe API v2.