Panoramica dell'API Reports
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Reports è un'API RESTful che puoi utilizzare per accedere alle informazioni sulle
attività di Google Workspace dei tuoi utenti. L'API Reports fa parte dell'API SDK Admin.
L'API Reports fornisce due tipi di report:
- I report Attività, che segnalano eventi per un'applicazione o un servizio specifico, come Google Drive o la Console di amministrazione.
- Report Utilizzo, che elencano gli eventi di Workspace causati dagli utenti.
- I report sull'utilizzo dei clienti elencano gli eventi per tutti gli utenti del tuo dominio.
- L'elenco dei report sull'utilizzo Utente mostra gli eventi organizzati per utente.
Di seguito è riportato un elenco di termini comuni utilizzati nell'API Reports:
- Report sull'attività
I report attività elencano le informazioni relative alle attività in un'applicazione o un servizio Google Workspace specifico. I report sull'attività includono data, ora, utente e tipo
di attività. I
riferimenti per le API
contengono un elenco completo dei report sull'attività e delle informazioni che includono.
Ecco alcuni esempi di report sull'attività, elencati per applicazione o servizio:
- I report sull'attività dell'amministratore
mostrano le attività svolte dagli amministratori utilizzando la Console di amministrazione. Ad esempio,
puoi ottenere un elenco di tutte le volte in cui gli amministratori hanno modificato il nome di un utente
utilizzando la Console di amministrazione.
- I report sull'attività di Google Drive
elencano le modifiche e le visualizzazioni dei documenti di Drive da parte degli utenti del tuo dominio. Ad esempio, puoi ottenere un elenco delle attività di un determinato utente su Drive.
- I report sull'attività di accesso
forniscono informazioni su quando gli utenti del tuo account accedono e escono dai loro
account. Ad esempio, puoi ottenere un report di tutti gli accessi al tuo
dominio in un determinato periodo di tempo.
- I report sull'attività mobile
mostrano le attività che utilizzano i dispositivi mobili gestiti da
Gestione dispositivi mobili Google.
Ad esempio, puoi ricevere una notifica quando gli utenti registrano un nuovo dispositivo.
- I report sull'attività dei token OAuth
elencano gli eventi in cui gli utenti hanno concesso o revocato i token di autorizzazione utilizzati
da siti web e applicazioni di terze parti. Puoi utilizzare l'API Reports per ottenere
un elenco di tutti gli accessi di terze parti ai dati di Google Workspace di un utente.
- Report sull'utilizzo
I report sull'utilizzo forniscono informazioni sugli eventi di Google Workspace nel tuo dominio.
Puoi utilizzare l'API per richiedere informazioni specifiche sugli utenti.
- I report sull'utilizzo dei clienti
elencano le attività dettagliate di applicazioni e servizi nel tuo account. Queste informazioni
sull'utilizzo sono organizzate per tipo di applicazione e contengono informazioni
specifiche per l'applicazione.
- I report sull'utilizzo degli utenti
mostrano le attività degli utenti del tuo account. Questi report possono essere personalizzati e
filtrati per informazioni sull'utilizzo specifiche. Queste informazioni sull'utilizzo sono organizzate
per tipo di applicazione e contengono informazioni specifiche per l'applicazione.
- I report sull'utilizzo delle entità
elencano le attività correlate alle entità utilizzate dagli utenti del tuo account nell'applicazione
Currents.
- Notifiche
- L'API Reports fornisce notifiche che ti consentono di monitorare gli eventi, ad esempio
le modifiche alle risorse. Quando guardi una risorsa e questa cambia,
l'API Reports ti invia una notifica. Per ulteriori informazioni sulla configurazione e sulla ricezione di notifiche dall'API Reports, consulta la guida alla ricezione di notifiche push.
Passaggi successivi
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 Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
