Il report sull'utilizzo degli utenti restituisce le informazioni sull'utilizzo dei servizi Google Workspace per un determinato utente del 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.
Il presente report sull'utilizzo degli utenti può essere utilizzato solo per scopi legali in conformità con il Contratto con il cliente. Inoltre, questi report si applicano a Google Workspace ed Education.
Recupera 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 relativa all'autorizzazione. Per favorire la leggibilità, il formato del seguente esempio è costituito da 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 indica 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à delle risposte, consulta la documentazione di riferimento API. Per informazioni sui parametri del report sull'utilizzo degli utenti, consulta la documentazione di riferimento sui parametri di utilizzo degli utenti.
L'esempio seguente restituisce un report su tutte le attività degli utenti per l'account.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
L'esempio seguente restituisce un report su tutte le attività degli utenti 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 restituisce un report sui timestamp dell'ultimo accesso degli utenti all'account. Per un esempio di risposta dell'API, vedi l'esempio di risposta 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 con i timestamp dell'ultimo accesso degli utenti all'account, filtrati in base agli utenti che hanno eseguito l'accesso dopo un intervallo di tempo specifico. Per un esempio di risposta dell'API, vedi l'esempio di risposta 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 degli ultimi accessi e sullo stato di sospensione degli utenti all'account. Per un esempio di risposta dell'API, vedi l'esempio di risposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
Recuperare 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 relativa all'autorizzazione. Per la leggibilità, l'esempio seguente è formattato con 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 indicato nel report o l'indirizzo email Google Workspace univoco dell'utente profileId. Il valore dates indica 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à delle risposte, consulta la documentazione di riferimento API. Per informazioni sui parametri del report sull'utilizzo degli utenti, consulta la documentazione di riferimento sui parametri di utilizzo degli utenti.
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 nel 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"
}
]
}
]
}