API Reports: report sull'utilizzo degli utenti

Il report sull'utilizzo degli utenti restituisce le informazioni sull'utilizzo del servizio Google Workspace per un determinato utente nel tuo dominio. Questi report possono essere personalizzati e filtrati in base a informazioni specifiche sull'utilizzo. Il periodo di tempo predefinito e massimo per ogni report corrisponde agli ultimi 450 giorni.

Questo report sull'utilizzo degli utenti può essere utilizzato solo per scopi legittimi in conformità con il Contratto con il cliente. Inoltre, questi report si applicano a Google Workspace ed Education.

Recuperare tutte le attività di utilizzo degli utenti

Per recuperare un report di tutte le attività utente nel tuo account, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione sull'autorizzazione. Per la leggibilità, l'esempio seguente è formattato con i ritorni a riga:

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date
?parameters=application: user usage parameter,...
&filters=application: user usage parameter relational operator usage parameter's value,...
&maxResults=number of events listed on each page of the report

Il valore dates è la data in cui si è verificato l'utilizzo e il timestamp è nel formato ISO 8601, aaaa-mm-gg. Per ulteriori informazioni sui parametri della stringa di query e sulle proprietà della risposta, consulta Riferimento API. Per informazioni sui parametri del report sull'utilizzo da parte degli utenti, consulta l'articolo Riferimento ai parametri di utilizzo dell'utente.

L'esempio seguente genera un report su tutte le attività utente per l'account.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all
/dates/2013-03-03?maxResults=2

L'esempio seguente genera un report su tutte le attività utente per un account cliente specifico.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all
/dates/2013-03-03?customerId=C03az79cb

L'esempio seguente genera un report sui timestamp dell'ultimo accesso degli utenti nell'account. Per un esempio di risposta dell'API, vedi l'esempio di risposta di JSON.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time&maxResults=2

L'esempio seguente restituisce un report sui timestamp dell'ultimo accesso degli utenti all'account, filtrati in base a quelli che hanno eseguito l'accesso dopo un determinato periodo di tempo. Per un esempio di risposta dell'API, vedi l'esempio di risposta di JSON.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time&filters=accounts:last_login_time
>2010-10-28T10:26:35.000Z"

L'esempio seguente restituisce un report sui timestamp dell'ultimo accesso e sullo stato di sospensione degli utenti dell'account. Per un esempio di risposta dell'API, vedi l'esempio di risposta di JSON.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time,accounts:is_disabled"

Recupera le attività di utilizzo di un utente specifico

Per recuperare un report sulle attività di un utente specifico nel tuo account, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione sulle autorizzazioni. Per migliorare la leggibilità, l'esempio seguente è formattato con i ritorni a riga.

GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date
?parameters=application: user usage parameter,...
&filters=application: user usage parameter relational operator usage parameter's value,...
&maxResults=number of events listed on each page of the report

userKey può essere l'indirizzo email principale dell'utente nel report o il profileId univoco di Google Workspace dell'utente. Il valore dates è la data in cui si è verificato l'utilizzo e il timestamp è nel formato ISO 8601, aaaa-mm-gg. Per ulteriori informazioni sui parametri della stringa di query e sulle proprietà della risposta, consulta Riferimento API. Per informazioni sui parametri del report sull'utilizzo da parte degli utenti, consulta l'articolo Riferimento ai parametri di utilizzo dell'utente.

L'esempio seguente restituisce il report sull'utilizzo per mario@example.com.

https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03

Esempio di risposta JSON per il report sull'utilizzo

Una risposta corretta restituisce un codice di stato HTTP 200. Insieme al codice di stato, la risposta restituisce un report.

Risposta JSON per segnalazione utente

{
 "kind": "reports#usageReports",
 "warnings": [
    {
      "code": warning machine-readable code,
      "message": warning human-readable message,
      "data": [
        {
          "key": key for key-value pair that gives detailed warning information,
          "value": value for key-value pair giving detailed warning information
        }
      ]
    }
  ],
 "nextPageToken": "N:NNN:NNN:N:C03az79cb",
 "usageReports": [
{
   "kind": "usageReport",
   "date": "2013-03-03",
   "entity": {
    "type": "USER",
    "customerId": "C03az79cb",
    "userEmail": "liz@example.com",
    "profileId": "user's unique Google Workspace ID"
   },
   "parameters": [
    {
      "name": "accounts:is_disabled",
      "boolValue": false
     },
    {
     "name": "accounts:disabled_reason",
     "stringValue": "reason description"
    },
    {
     "name": "accounts:first_name",
     "stringValue": "Liz"
    },
    {
     "name": "accounts:is_2sv_enforced",
     "boolValue": false
    },
    {
     "name": "accounts:is_2sv_enrolled",
     "boolValue": false
    },
    {
     "name": "accounts:last_name",
     "stringValue": "Smith"
    },
    {
     "name": "accounts:creation_time",
     "datetimeValue": "2010-10-28T10:26:35.000Z"
    },
    {
     "name": "accounts:last_login_time",
     "datetimeValue": "1970-01-01T00:00:00.000Z"
    },
    {
     "name": "accounts:last_sso_time",
     "datetimeValue": "1970-01-01T00:00:00.000Z"
    }
   ]
  }
 ]
}