Skip to main content
POST
Nutzerseitenanalysen abrufen

Überblick

Rufen Sie Statistiken zur Nutzeraktivität ab, die auf der Teams-Seite angezeigt werden, darunter Nutzernamen, E-Mail-Adressen, Zeitpunkte der letzten Aktivität, aktive Tage und verwendete Prompt-Credits.

Anfrage

string
erforderlich
Ihr Service-Schlüssel mit den Berechtigungen „Teams Read-only“
string
Ergebnisse nach Nutzern in einer bestimmten Gruppe filtern (optional)
string
Startzeitpunkt im RFC-3339-Format (z. B. 2023-01-01T00:00:00Z). Wirkt sich nur auf die Berechnung von activeDays aus. Falls nicht angegeben, wird standardmäßig der Zeitpunkt vor 1 Jahr verwendet.
string
Endzeitpunkt im RFC-3339-Format (z. B. 2023-12-31T23:59:59Z). Wirkt sich nur auf die Berechnung von activeDays aus. Falls nicht angegeben, wird standardmäßig die aktuelle Zeit verwendet.

Beispielanfrage

Antwort

Bei Nicht-Devin-Teams enthält apiKey einen unverschlüsselten API-Schlüssel des Nutzers, keinen Hash. Behandeln Sie ihn als Secret: Entfernen oder schwärzen Sie ihn, bevor Sie Analytics protokollieren, exportieren oder teilen. Falls Sie ungeschwärzte Antworten aufbewahren müssen, beschränken Sie den Zugriff und speichern Sie sie sicher.
array
Array aus Objekten mit Nutzerstatistiken
string
Der Beginn des aktuellen Abrechnungszeitraums im RFC-3339-Format. Die Werte promptCreditsUsed in userTableStats entsprechen der Nutzung innerhalb dieses Abrechnungszeitraums.
string
Das Ende des aktuellen Abrechnungszeitraums im RFC-3339-Format. Die Werte promptCreditsUsed in userTableStats entsprechen der Nutzung innerhalb dieses Abrechnungszeitraums.

Beispielantwort

Die folgenden apiKey-Werte sind Beispielplatzhalter und keine echten Anmeldedaten.

Fehlerantworten

string
Fehlermeldung, die beschreibt, was schiefgelaufen ist
Häufige Fehlerszenarien:
  • Ungültiger Service-Schlüssel oder unzureichende Berechtigungen
  • Ungültiges Zeitstempelformat
  • Gruppe nicht gefunden
  • Rate-Limit überschritten