API Reports: Report Utilizzo clienti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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
},
...
]
}
]
}
]
}
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Reports API: Customers Usage Report\n\nThe Customers usage report\naggregates Google Workspace service usage information, for all users, across an entire domain.\nThe user usage report returns Google Workspace service usage information across your account.\nThis usage information is organized by application type which is composed of parameters specific to that application.\nThe default and maximum time period for each report is the last 450 days.\n\nThese usage report may be used only for lawful purposes in accordance with your Customer Agreement. Also, these\nreports apply to Google Workspace and Education.\n\nRetrieve a customer usage report\n--------------------------------\n\nTo retrieve report of your account activities use the following `GET` HTTP request and include the authorization token\ndescribed in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For readability,\nthe following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date\n?parameters=app name: usage parameter,...\n&customerId=the customer's ID\n&maxResults=number of events listed on each page of the report\n```\n\nThe `dates` value is the date the usage occurred and the timestamp is in the [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601), yyyy-mm-dd. We recommend you use your account's time zone for this. For more information about the request's query strings and response properties, see the [API Reference](/workspace/admin/reports/v1/reference/customerUsageReports/get) and the [customer usage report parameters reference](/workspace/admin/reports/v1/reference/usage-ref-appendix-a/customers).\n\nThe following example gets a report with the total of all successful logins to your account in the past 30 days and a list\nof authorized applications, with the number of user authorizations per application, starting 2013-03-03. The `maxResults`\nquery string shows this report returns two events per report page: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03\n?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2\n```\n\n#### JSON response for customer usage report\n\n```carbon\n{\n \"kind\": \"reports#usageReports\",\n \"warnings\": [\n {\n \"code\": warning machine-readable code,\n \"message\": warning human-readable message,\n \"data\": [\n {\n \"key\": key for key-value pair that gives detailed warning information,\n \"value\": value for key-value pair giving detailed warning information\n }\n ]\n }\n ],\n \"nextPageToken\": \"N:NNN:NNN:N:C03az79cb\",\n \"usageReports\": [\n {\n \"kind\": \"usageReport\",\n \"date\": \"2013-03-03\",\n \"entity\": {\n \"type\": \"CUSTOMER\",\n \"customerId\": \"C03az79cb\"\n },\n \"parameters\": [\n {\n \"name\": \"accounts:num_1day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_30day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_7day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_disabled_accounts\",\n \"intValue\": \"5\"\n },\n {\n \"name\": \"accounts:authorized_apps\",\n \"msgValue\": [\n {\n \"client_id\": \"1234.apps.googleusercontent.com\",\n \"client_name\": \"www.example.com\",\n \"num_users\": 2\n },\n {\n \"client_id\": \"4567.apps.googleusercontent.com\",\n \"client_name\": \"Example\",\n \"num_users\": 1\n },\n ...\n ]\n }\n ]\n }\n ]\n}\n```"]]
