Zum Hauptinhalt springen
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

service_key
string
erforderlich
Ihr Service-Schlüssel mit den Berechtigungen „Teams Read-only“
group_name
string
Ergebnisse nach Nutzern in einer bestimmten Gruppe filtern (optional)
start_timestamp
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.
end_timestamp
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

userTableStats
array
Array aus Objekten mit Nutzerstatistiken
billingCycleStart
string
Der Beginn des aktuellen Abrechnungszeitraums im RFC-3339-Format. Die Werte promptCreditsUsed in userTableStats entsprechen der Nutzung innerhalb dieses Abrechnungszeitraums.
billingCycleEnd
string
Das Ende des aktuellen Abrechnungszeitraums im RFC-3339-Format. Die Werte promptCreditsUsed in userTableStats entsprechen der Nutzung innerhalb dieses Abrechnungszeitraums.

Beispielantwort

Fehlerantworten

error
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