Scegli gli ambiti dell'API Reports

Questo documento contiene informazioni di autorizzazione e autenticazione specifiche per l'API Alert Center. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace in Scopri di più su autenticazione e autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configura la schermata per il consenso OAuth e scegli gli ambiti per definire quali informazioni mostrare agli utenti e ai revisori di app e registra la tua app in modo da poterla pubblicare in un secondo momento.

Ambiti API Reports

Per definire il livello di accesso concesso alla tua app, devi identificare e dichiarare gli ambiti di autorizzazione. Un ambito di autorizzazione è una stringa URI OAuth 2.0 che contiene il nome dell'app Google Workspace, il tipo di dati a cui accede e il livello di accesso. Gli ambiti sono le richieste dell'app di utilizzo dei dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.

Al momento dell'installazione dell'app, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, conviene scegliere l'ambito più specifico possibile ed evitare di richiedere ambiti non richiesti dall'app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti chiaramente.

L'API Reports supporta i seguenti ambiti:

Ambiti Significato
https://www.googleapis.com/auth/admin.reports.audit.readonly Visualizza i report di controllo per il tuo dominio Google Workspace
https://www.googleapis.com/auth/admin.reports.usage.readonly Visualizza i report sull'utilizzo per il tuo dominio Google Workspace