Las API de análisis proporcionan métricas agregadas sobre el uso y la actividad de un Espacio de trabajo de ChatGPT. La API unificada de análisis de uso diario proporciona métricas diarias de uso de ChatGPT, de Codex y del modo Work. Antes de usar el punto de acceso, confirma que esté habilitado para tu Espacio de trabajo.
La documentación de referencia de la API de administración es la fuente oficial de información actualizada sobre los requisitos de acceso, las rutas, los esquemas de solicitudes y respuestas, las métricas, la interpretación de los valores de tiempo y la paginación.
Cuándo usar la API de análisis
La API de análisis es adecuada cuando necesitas:
- Automatizar la generación de informes periódicos sobre el uso del Espacio de trabajo.
- Combinar métricas de uso agregadas con datos internos de tu organización.
- Crear una capa de informes con acceso controlado para grupos autorizados.
- Evitar que una integración dependa de un panel interactivo.
Esta API no ofrece acceso a los registros de auditoría sin procesar. Usa la API de Cumplimiento cuando el flujo de trabajo requiera registros de actividad auditables.
Confirma el alcance del acceso administrativo
Los resultados de la API de análisis se limitan a un Espacio de trabajo de ChatGPT. Para usar la API unificada de análisis de uso diario, utiliza una clave de administración limitada al Espacio de trabajo y con el permiso enterprise.analytics.usage.read. El permiso de Codex codex.enterprise.analytics.read no permite usar ese punto de acceso.
La documentación de referencia de la API especifica cómo se aprovisionan las claves, qué permisos se requieren, qué rutas, esquemas y campos están vigentes, cómo se interpretan los valores de tiempo y cómo funciona la paginación. Esta página no reproduce esas especificaciones.