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:
- Report Attività, che registrano gli eventi per un'applicazione o un servizio specifico, come Google Drive o la Console di amministrazione.
- Report Utilizzo, che elencano gli eventi dello spazio di lavoro causati dagli utenti.
- I report sull'utilizzo dei clienti elencano gli eventi per tutti gli utenti del tuo dominio.
- I report sull'utilizzo per utente elencano gli eventi organizzati per utente.
Di seguito è riportato un elenco di termini comuni utilizzati nell'API Reports:
- Report sulle attività
I report Attività elencano le informazioni relative alle attività in un'applicazione o un servizio Google Workspace specifico. I report sulle attività includono data, ora, utente e tipo di attività. Il riferimento all'API contiene un elenco completo dei report sulle attività e delle informazioni che includono. Ecco alcuni esempi di report sulle attività, elencati per applicazione o servizio:
- I report sull'attività dell'amministratore mostrano le attività svolte dagli amministratori che utilizzano la Console di amministrazione. Ad esempio, puoi ottenere un elenco di tutte le volte che gli amministratori hanno modificato il nome di un utente utilizzando la Console di amministrazione.
- I report sulle attività di Google Drive elencano in che modo gli utenti del tuo dominio modificano e visualizzano i documenti di Drive. Ad esempio, puoi ottenere un elenco delle attività di un determinato utente su Drive.
- I report sulle attività di accesso forniscono informazioni su quando gli utenti del tuo account accedono e escono dai propri account. Ad esempio, puoi generare un report di tutti gli accessi al tuo dominio in un determinato periodo di tempo.
- I report sulle attività dei dispositivi mobili 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 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 Report per ottenere un elenco di tutto l'accesso 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 in base al 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 in base a 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à relative alle entità utilizzate dagli utenti del tuo account nell'applicazione Currents.
- Notifiche
- L'API Reports fornisce notifiche che ti consentono di monitorare eventi, ad esempio modifiche alle risorse. Quando stai osservando una risorsa e questa cambia, l'API Reports ti invia una notifica. Per ulteriori informazioni sulla configurazione e sulla ricezione delle notifiche dall'API Reports, consulta la guida alla ricezione delle notifiche push.
Passaggi successivi
Per scoprire di più sull'API Report e come funziona, utilizza una guida rapida, elencata per linguaggio di programmazione nella barra di navigazione a sinistra. Puoi anche continuare a leggere questa sezione per informazioni generali sulla configurazione del tuo account.
La sezione Autorizzazione illustra come utilizzare i token di accesso OAuth 2.0 per ottenere i dati utente dalle applicazioni e dai servizi Google Workspace.
Per trovare i dettagli di un tipo di risorsa o di un metodo specifico, consulta il riferimento API.
Per saperne di più, consulta il tracker dei problemi dell'API Admin SDK, il blog per sviluppatori di Google Workspace e il Centro assistenza Amministrazione Google Workspace.