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

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

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