> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ユーザーページのAnalyticsを取得する

> Teamsページから、名前、emails、最終アクティビティ時刻、およびアクティブ日数を含むユーザーのアクティビティ統計を取得します。

<div id="overview">
  ## 概要
</div>

Teams ページに表示されるユーザーのアクティビティ統計を取得します。ユーザー名、emails、最終アクティビティ時刻、アクティブ日数が含まれます。

<div id="request">
  ## リクエスト
</div>

<ParamField body="service_key" type="string" required>
  Teams Read-only 権限を持つサービスキー
</ParamField>

<ParamField body="group_name" type="string">
  特定のグループのユーザーに結果を絞り込み（任意）
</ParamField>

<ParamField body="start_timestamp" type="string">
  RFC 3339 形式の開始時刻（例: `2023-01-01T00:00:00Z`）
</ParamField>

<ParamField body="end_timestamp" type="string">
  RFC 3339 形式の終了時刻（例: `2023-12-31T23:59:59Z`）
</ParamField>

<div id="example-request">
  ### リクエストの例
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2024-01-01T00:00:00Z",
  "end_timestamp": "2024-12-31T23:59:59Z"
}' \
https://server.codeium.com/api/v1/UserPageAnalytics
```

<div id="response">
  ## レスポンス
</div>

<ResponseField name="userTableStats" type="array">
  ユーザー統計情報オブジェクトの配列

  <Expandable title="ユーザー統計情報オブジェクト">
    <ResponseField name="name" type="string">
      ユーザーの表示名
    </ResponseField>

    <ResponseField name="email" type="string">
      ユーザーのメールアドレス
    </ResponseField>

    <ResponseField name="lastUpdateTime" type="string">
      ユーザーの最終アクティビティを表す、RFC 3339 形式のタイムスタンプ
    </ResponseField>

    <ResponseField name="apiKey" type="string">
      ユーザーの API キーをハッシュ化した値
    </ResponseField>

    <ResponseField name="activeDays" type="number">
      クエリ対象期間中にユーザーがアクティブだった合計日数
    </ResponseField>

    <ResponseField name="disableCodeium" type="boolean">
      管理者によってユーザーの Windsurf へのアクセスが無効化されているかどうかを示します。このフィールドはアクセスが明示的に無効化されている場合にのみ存在し、その場合は常に true に設定されます。
    </ResponseField>

    <ResponseField name="lastAutocompleteUsageTime" type="string">
      Tab/Autocomplete モダリティが最後に使用された時刻を表す、RFC 3339 形式のタイムスタンプ
    </ResponseField>

    <ResponseField name="lastChatUsageTime" type="string">
      Cascade モダリティが最後に使用された時刻を表す、RFC 3339 形式のタイムスタンプ
    </ResponseField>

    <ResponseField name="lastCommandUsageTime" type="string">
      Command モダリティが最後に使用された時刻を表す、RFC 3339 形式のタイムスタンプ
    </ResponseField>

    <ResponseField name="teamStatus" type="string">
      ユーザーのチームメンバーシップステータス。取りうる値: `USER_TEAM_STATUS_UNSPECIFIED`, `USER_TEAM_STATUS_PENDING`, `USER_TEAM_STATUS_APPROVED`, `USER_TEAM_STATUS_REJECTED`。API はチームステータスに関わらずすべてのユーザーを返しますが、「Manage Members」UI には承認済みユーザーのみが表示されます。
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### レスポンス例
</div>

```json theme={null}
{
  "userTableStats": [
    {
      "name": "Alice",
      "email": "alice@windsurf.com",
      "lastUpdateTime": "2024-10-10T22:56:10.771591Z",
      "apiKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "activeDays": 178,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    },
    {
      "name": "Bob",
      "email": "bob@windsurf.com",
      "lastUpdateTime": "2024-10-10T18:11:23.980237Z",
      "apiKey": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "activeDays": 462,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    },
    {
      "name": "Charlie",
      "email": "charlie@windsurf.com",
      "lastUpdateTime": "2024-10-10T16:43:46.117870Z",
      "apiKey": "cccccccc-cccc-cccc-cccc-cccccccccccc",
      "activeDays": 237,
      "teamStatus": "USER_TEAM_STATUS_PENDING"
    }
  ]
}
```

<div id="error-responses">
  ## エラー レスポンス
</div>

<ResponseField name="error" type="string">
  問題の内容を説明するエラーメッセージ
</ResponseField>

一般的なエラーシナリオ:

* 無効なサービスキー、または権限不足
* 無効なタイムスタンプ形式
* 対象グループが見つからない
* レート制限を超過している
