メインコンテンツへスキップ
POST
ユーザーページ分析を取得

概要

Teamsページに表示されるユーザーアクティビティの統計情報を取得します。これには、ユーザー名、メールアドレス、最終アクティビティ時刻、アクティブだった日数、利用したプロンプトクレジットが含まれます。

リクエスト

service_key
string
必須
“Teams Read-only” 権限を持つサービスキー
group_name
string
特定のグループに属するユーザーに結果を絞り込みます (省略可)
start_timestamp
string
RFC 3339 形式の開始時刻 (例: 2023-01-01T00:00:00Z) 。activeDays の計算にのみ影響します。 指定しない場合、デフォルトで 1 年前の時刻が使用されます。
end_timestamp
string
RFC 3339 形式の終了時刻 (例: 2023-12-31T23:59:59Z) 。activeDays の計算にのみ影響します。 指定しない場合、デフォルトで現在時刻が使用されます。

リクエスト例

応答

userTableStats
array
ユーザー統計オブジェクトの配列
billingCycleStart
string
現在の請求サイクルの開始時点 (RFC 3339形式) です。userTableStats 内の promptCreditsUsed の値は、この請求サイクル内の使用量に対応します。
billingCycleEnd
string
現在の請求サイクルの終了時点 (RFC 3339形式) です。userTableStats 内の promptCreditsUsed の値は、この請求サイクル内の使用量に対応します。

レスポンスの例

エラーレスポンス

error
string
問題の内容を説明するエラーメッセージ
一般的なエラー例:
  • サービスキーが無効、または権限が不足している
  • タイムスタンプの形式が無効
  • グループが見つかりません
  • レート制限を超えました