Analytics API
Verstehen Sie den Zweck und die administrative Abgrenzung der Codex Analytics API
Die Analytics APIs liefern aggregierte Nutzungs- und Aktivitätskennzahlen für einen ChatGPT- Workspace. Die einheitliche Daily Usage Analytics API erfasst die tägliche Nutzung von ChatGPT, Codex und Work. Vergewissern Sie sich vor der Verwendung, dass der Endpunkt für Ihren Workspace aktiviert ist.
Die Admin-API-Referenz ist die maßgebliche Quelle für aktuelle Zugriffsanforderungen, Routen, Anfrage- und Antwortschemas, Kennzahlen, Zeitsemantik und Paginierung.
Wann Sie die Analytics API verwenden sollten
Die Analytics API eignet sich, wenn Sie Folgendes benötigen:
- Regelmäßige Berichte zur Workspace-Nutzung automatisieren.
- Aggregierte Nutzungskennzahlen mit internen Organisationsdaten verknüpfen.
- Eine kontrollierte Berichtsebene für autorisierte Zielgruppen aufbauen.
- Die Kopplung einer Integration an ein interaktives Dashboard vermeiden.
Sie ist keine Schnittstelle für rohe Audit-Protokolle. Verwenden Sie die Compliance API, wenn der Workflow auditierbare Aktivitätsdatensätze erfordert.
Administrative Abgrenzungen bestätigen
Ergebnisse der Analytics API sind auf einen ChatGPT-Workspace beschränkt. Verwenden Sie für die einheitliche Daily
Usage Analytics API einen auf den Workspace beschränkten Admin-Schlüssel mit
enterprise.analytics.usage.read. Der Codex-Berechtigungsbereich
codex.enterprise.analytics.read gewährt keinen Zugriff auf diesen Endpunkt.
Die API-Referenz ist maßgeblich für die aktuelle Schlüsselbereitstellung, Anforderungen an Berechtigungsbereiche, Routen, Schemas, Felder, Zeitsemantik und das Paginierungsverhalten. Diese Seite wiederholt diesen Vertrag nicht.