Die Analytics APIs liefern aggregierte Kennzahlen zur Nutzung und Aktivität in einem ChatGPT-Workspace. Die einheitliche Daily Usage Analytics API liefert Tageswerte für die Nutzung von ChatGPT, Codex und Work. Prüfe vor der Verwendung, ob der Endpunkt für deinen Workspace aktiviert ist.
Die Referenz zur Admin API ist die maßgebliche Quelle für die aktuellen Zugriffsanforderungen, Routen, Anfrage- und Antwortschemas, Metriken, die Bedeutung von Zeitangaben und die Paginierung.
Wann du die Analytics API einsetzen solltest
Die Analytics API eignet sich für folgende Aufgaben:
- Regelmäßige Berichte zur Nutzung deines Workspaces automatisieren.
- Aggregierte Nutzungskennzahlen mit internen Organisationsdaten verknüpfen.
- Ein Berichtssystem mit geregeltem Zugriff für berechtigte Zielgruppen aufbauen.
- Eine Integration unabhängig von einem interaktiven Dashboard betreiben.
Die API bietet keinen Zugriff auf Audit-Rohprotokolle. Verwende die Compliance API, wenn du für deinen Workflow prüfbare Aktivitätsnachweise benötigst.
Geltungsbereich und Berechtigungen prüfen
Die Ergebnisse der Analytics API beziehen sich jeweils auf einen einzelnen ChatGPT-Workspace. Verwende für die einheitliche Daily Usage Analytics API einen Admin-Schlüssel, der auf diesen Workspace beschränkt ist und den Scope enterprise.analytics.usage.read hat. Der Codex-Scope codex.enterprise.analytics.read gewährt keinen Zugriff auf diesen Endpunkt.
Die API-Referenz beschreibt, wie du Schlüssel bereitstellst, welche Scopes erforderlich sind, welche Routen, Schemas und Felder gelten, wie Zeitangaben zu verstehen sind und wie die Paginierung funktioniert. Diese Seite wiederholt die Spezifikation nicht.