Panoramica dell'API Reports

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 Admin SDK.

L'API Reports fornisce due tipi di report:

  • Report sulle attività, che segnalano eventi per un'applicazione o un servizio specifico, come Google Drive o la Console di amministrazione.
  • Report sull'utilizzo, che elencano gli eventi dell'area di lavoro causati dagli utenti.
    • Nei report sull'utilizzo dei clienti sono elencati gli eventi di tutti gli utenti del dominio.
    • Nei report di utilizzo degli utenti sono elencati gli eventi organizzati per utente.

Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Reports:

Report Attività

I report sulle attività elencano le informazioni sulle attività in una specifica applicazione o servizio Google Workspace. I rapporti sulle attività includono la data, l'ora, l'utente e il tipo di attività. Il riferimento API contiene un elenco completo dei report sulle attività e le informazioni che includono. Ecco alcuni esempi di report sulle attività, elencati per applicazione o servizio:

  • I report sulle attività di amministrazione mostrano le attività eseguite dagli amministratori utilizzando la Console di amministrazione. Ad esempio, potresti ottenere un elenco di tutte le volte in cui gli amministratori hanno cambiato il nome di un utente utilizzando la Console di amministrazione.
  • I report sulle attività di Google Drive mostrano come gli utenti del dominio modificano e visualizzano i documenti di Drive. Ad esempio, puoi visualizzare un elenco delle attività di un utente specifico su Drive.
  • I report Attività di accesso forniscono informazioni su quando gli utenti dell'account accedono e quando escono dai propri account. Ad esempio, puoi visualizzare un report di tutti gli accessi per il tuo dominio in un determinato periodo di tempo.
  • I report Attività sui 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 sulle attività dei token OAuth elencano gli eventi quando 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 di 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 di utilizzo dei clienti elencano le attività dettagliate relative alle applicazioni e ai servizi nel tuo account. Queste informazioni di utilizzo sono organizzate per tipo di applicazione e contengono informazioni specifiche per l'applicazione.
  • I report Utilizzo utenti mostrano le attività in base agli utenti del tuo account. Questi report possono essere personalizzati e filtrati per avere informazioni sull'utilizzo specifiche. Queste informazioni di utilizzo sono organizzate per tipo di applicazione e contengono informazioni specifiche per l'applicazione.
  • I report di 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 controllare gli eventi, ad esempio le modifiche alle risorse. Quando stai guardando una risorsa e questa cambia, l'API Reports ti invia una notifica. Per scoprire di più sulla configurazione e la ricezione delle notifiche dall'API Reports, consulta la guida alla ricezione di notifiche push.

Passaggi successivi

  • Per informazioni sull'API Reports e sul suo funzionamento, utilizza una guida rapida, elencata per lingua di programmazione nella barra di navigazione a sinistra. Puoi anche continuare attraverso questa sezione per leggere informazioni generali sulla configurazione del tuo account.

  • Per utilizzare l'API Reports, segui i passaggi prerequisiti per configurare il tuo account e diventare un amministratore. Creerai anche un progetto e lo registrerai utilizzando la console API di Google e attiverai il servizio API Reports.

  • La sezione Autorizzazione mostra come utilizzare i token di accesso OAuth 2.0 per ottenere dati utente da applicazioni e servizi Google Workspace.

  • Per trovare i dettagli di un tipo di risorsa o di un metodo specifico, consulta la Riferimento API.

  • Per ulteriori informazioni, consulta il Issue Tracker dell'API SDK SDK, il blog di Google Workspace Developers e il Centro assistenza per gli amministratori di Google Workspace.