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

# Recupera le statistiche della pagina utenti

> Recupera le statistiche di attività degli utenti, inclusi nomi, email, orari dell'ultima attività, giorni attivi e crediti prompt utilizzati nella pagina Teams.

<div id="overview">
  ## Panoramica
</div>

Recupera le statistiche sull'attività degli utenti presenti nella pagina Teams, inclusi nomi degli utenti, email, orari dell'ultima attività, giorni attivi e crediti prompt utilizzati.

<div id="request">
  ## Richiesta
</div>

<ParamField body="service_key" type="string" required>
  La tua chiave di servizio con autorizzazioni "Teams sola lettura"
</ParamField>

<ParamField body="group_name" type="string">
  Filtra i risultati per gli utenti di un gruppo specifico (facoltativo)
</ParamField>

<ParamField body="start_timestamp" type="string">
  Timestamp iniziale nel formato RFC 3339 (ad es. `2023-01-01T00:00:00Z`). **Influisce solo sul calcolo di `activeDays`.** Se non viene fornito, il valore predefinito è 1 anno fa.
</ParamField>

<ParamField body="end_timestamp" type="string">
  Timestamp finale nel formato RFC 3339 (ad es. `2023-12-31T23:59:59Z`). **Influisce solo sul calcolo di `activeDays`.** Se non viene fornito, il valore predefinito è l'ora corrente.
</ParamField>

<div id="example-request">
  ### Esempio di richiesta
</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">
  ## Risposta
</div>

<ResponseField name="userTableStats" type="array">
  Array di oggetti contenenti statistiche sugli utenti

  <Expandable title="Oggetto statistiche utente">
    <ResponseField name="name" type="string">
      Nome visualizzato dell'utente
    </ResponseField>

    <ResponseField name="email" type="string">
      Indirizzo email dell'utente
    </ResponseField>

    <ResponseField name="lastUpdateTime" type="string">
      Timestamp dell'ultima attività dell'utente in formato RFC 3339
    </ResponseField>

    <ResponseField name="apiKey" type="string">
      Versione hash dell'API key dell'utente
    </ResponseField>

    <ResponseField name="activeDays" type="number">
      Numero di giorni in cui l'utente è stato attivo nell'intervallo di tempo richiesto (definito da `start_timestamp` e `end_timestamp`). Un giorno viene conteggiato come attivo se in quel giorno l'utente ha avuto accettazioni di Autocomplete, utilizzo di Cascade o utilizzo di Command.
    </ResponseField>

    <ResponseField name="disableCodeium" type="boolean">
      Indica se un admin ha disabilitato l'accesso a Devin Desktop per l'utente. Questo campo è presente solo se l'accesso è stato disabilitato esplicitamente e, in tal caso, sarà sempre impostato su true.
    </ResponseField>

    <ResponseField name="role" type="string">
      Il ruolo dell'utente all'interno del team (ad es. admin, membro)
    </ResponseField>

    <ResponseField name="signupTime" type="string">
      Timestamp della registrazione dell'utente, in formato RFC 3339
    </ResponseField>

    <ResponseField name="lastAutocompleteUsageTime" type="string">
      Il timestamp più recente di utilizzo della modalità Tab/Autocomplete, in formato RFC 3339
    </ResponseField>

    <ResponseField name="lastChatUsageTime" type="string">
      Il timestamp più recente di utilizzo della modalità Cascade, in formato RFC 3339
    </ResponseField>

    <ResponseField name="lastCommandUsageTime" type="string">
      Il timestamp più recente di utilizzo della modalità Command, in formato RFC 3339
    </ResponseField>

    <ResponseField name="promptCreditsUsed" type="number">
      Il numero totale di credito prompt utilizzato da questo utente durante il **ciclo di fatturazione corrente**, restituito in **centesimi** (1 credito = 100 centesimi). Per ottenere il consumo effettivo di crediti, dividi questo valore per 100. Questo valore **non** è influenzato dai parametri della richiesta `start_timestamp` o `end_timestamp`. L'intervallo del ciclo di fatturazione è indicato dai campi di primo livello `billingCycleStart` e `billingCycleEnd`.
    </ResponseField>

    <ResponseField name="teamStatus" type="string">
      Lo stato di appartenenza dell'utente al team. Valori possibili: `USER_TEAM_STATUS_UNSPECIFIED`, `USER_TEAM_STATUS_PENDING`, `USER_TEAM_STATUS_APPROVED`, `USER_TEAM_STATUS_REJECTED`. Tieni presente che l'API restituisce tutti gli utenti indipendentemente dal loro stato di appartenenza al team, mentre la UI Manage Members mostra solo gli utenti approvati.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="billingCycleStart" type="string">
  Inizio del ciclo di fatturazione corrente in formato RFC 3339. I valori `promptCreditsUsed` in `userTableStats` corrispondono all'utilizzo in questo ciclo di fatturazione.
</ResponseField>

<ResponseField name="billingCycleEnd" type="string">
  Fine del ciclo di fatturazione corrente in formato RFC 3339. I valori `promptCreditsUsed` in `userTableStats` corrispondono all'utilizzo in questo ciclo di fatturazione.
</ResponseField>

<div id="example-response">
  ### Esempio di risposta
</div>

```json theme={null}
{
  "userTableStats": [
    {
      "name": "Alice",
      "email": "alice@cognition.ai",
      "lastUpdateTime": "2024-10-10T22:56:10.771591Z",
      "apiKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "activeDays": 178,
      "role": "admin",
      "signupTime": "2024-01-15T08:30:00Z",
      "lastAutocompleteUsageTime": "2024-10-10T22:56:10Z",
      "lastChatUsageTime": "2024-10-10T20:30:00Z",
      "promptCreditsUsed": 12500,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    },
    {
      "name": "Bob",
      "email": "bob@cognition.ai",
      "lastUpdateTime": "2024-10-10T18:11:23.980237Z",
      "apiKey": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "activeDays": 210,
      "role": "member",
      "signupTime": "2024-02-01T10:00:00Z",
      "lastAutocompleteUsageTime": "2024-10-10T18:11:23Z",
      "lastChatUsageTime": "2024-10-09T14:22:00Z",
      "lastCommandUsageTime": "2024-10-08T09:15:00Z",
      "promptCreditsUsed": 8300,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    }
  ],
  "billingCycleStart": "2024-10-01T00:00:00Z",
  "billingCycleEnd": "2024-11-01T00:00:00Z"
}
```

<div id="error-responses">
  ## Risposte di errore
</div>

<ResponseField name="error" type="string">
  Messaggio di errore che descrive il problema
</ResponseField>

Scenari di errore comuni:

* Chiave di servizio non valida o autorizzazioni insufficienti
* Formato del timestamp non valido
* Gruppo non trovato
* Limite di richieste superato