API Reports: Report Utilizzo clienti

Il report Utilizzo da parte dei clienti aggrega le informazioni sull'utilizzo del servizio Google Workspace per tutti gli utenti dell'intero dominio. Il report sull'utilizzo degli utenti restituisce le informazioni sull'utilizzo del servizio Google Workspace per il tuo account. Queste informazioni sull'utilizzo sono organizzate per tipo di applicazione, che è composto da parametri specifici dell'applicazione. Il periodo di tempo predefinito e massimo per ogni report corrisponde agli ultimi 450 giorni.

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

Recuperare un report sull'utilizzo del cliente

Per recuperare un report sulle attività del tuo account, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione sull'autorizzazione. Per una migliore leggibilità, l'esempio seguente è formattato con i 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 è la data in cui si è verificato l'utilizzo e il timestamp è nel formato ISO 8601, aaaa-mm-gg. A questo scopo, ti consigliamo di utilizzare il fuso orario del tuo account. Per ulteriori informazioni sulle stringhe di query e sulle proprietà di risposta della richiesta, consulta Riferimento API e Riferimento per i parametri dei report sull'utilizzo da parte del cliente.

L'esempio seguente genera 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 03/03/2013. maxResults la stringa di query 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
      },
     ...
     ]
    }
   ]
  }
 ]
}