Il report Utilizzo da parte dei clienti aggrega le informazioni sull'utilizzo dei servizi Google Workspace, per tutti gli utenti, nell'intero dominio. Il report sull'utilizzo degli utenti restituisce le informazioni sull'utilizzo del servizio Google Workspace nel tuo account. Queste informazioni sull'utilizzo sono organizzate per tipo di applicazione, che è composta da parametri specifici dell'applicazione. Il periodo di tempo predefinito e massimo per ogni report corrisponde agli ultimi 450 giorni.
Il presente report sull'utilizzo 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 un report sull'utilizzo da parte dei clienti
Per recuperare il report delle attività del tuo account, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione
descritto nella documentazione relativa all'autorizzazione. Per una migliore leggibilità,
l'esempio seguente è formattato con ritorni a riga:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date ?parameters=app name: usage parameter,... &customerId=the customer's ID &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. Ti consigliamo di utilizzare il fuso orario del tuo account. Per ulteriori informazioni sulle stringhe di query e sulle proprietà delle risposte della richiesta, consulta gli articoli Riferimento API e Parametri del report di utilizzo del cliente.
L'esempio seguente restituisce un report con il totale di tutti gli accessi riusciti al tuo account negli ultimi 30 giorni e un elenco di applicazioni autorizzate, con il numero di autorizzazioni utente per applicazione, a partire dal 3/03/2013. La stringa di query maxResults mostra che questo report restituisce due eventi per pagina del report:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03 ?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2
Risposta JSON per il report sull'utilizzo del cliente
{
"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": "CUSTOMER",
"customerId": "C03az79cb"
},
"parameters": [
{
"name": "accounts:num_1day_logins",
"intValue": "1"
},
{
"name": "accounts:num_30day_logins",
"intValue": "1"
},
{
"name": "accounts:num_7day_logins",
"intValue": "1"
},
{
"name": "accounts:num_disabled_accounts",
"intValue": "5"
},
{
"name": "accounts:authorized_apps",
"msgValue": [
{
"client_id": "1234.apps.googleusercontent.com",
"client_name": "www.example.com",
"num_users": 2
},
{
"client_id": "4567.apps.googleusercontent.com",
"client_name": "Example",
"num_users": 1
},
...
]
}
]
}
]
}