Scegli gli ambiti dell'API Fogli Google

Questo documento contiene informazioni di autorizzazione e autenticazione specifiche dell'API Fogli Google. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace nella pagina 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 le informazioni da mostrare a utenti e revisori di app e registra la tua app in modo da poterla pubblicare in un secondo momento.

Ambiti API Fogli

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 della tua app di utilizzo dei dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.

Una volta installata l'app, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, dovresti 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 chiaramente descritti.

Quando possibile, ti consigliamo di utilizzare ambiti non sensibili, in quanto concede l'ambito di accesso per file e limita l'accesso a funzionalità specifiche richieste da un'app.

L'API Fogli supporta i seguenti ambiti:

Codice ambito Descrizione Utilizzo
https://www.googleapis.com/auth/spreadsheets Visualizza, modifica, crea ed elimina tutti i tuoi fogli di lavoro di Fogli Google. Sensibile
https://www.googleapis.com/auth/spreadsheets.readonly Visualizza tutti i tuoi fogli di lavoro di Fogli Google. Sensibile
https://www.googleapis.com/auth/drive.file Visualizza, modifica, crea ed elimina solo i file specifici di Google Drive che utilizzi con questa app. Consigliato
Non sensibile
https://www.googleapis.com/auth/drive Visualizzare, modificare, creare ed eliminare tutti i tuoi file di Google Drive. Con restrizioni
https://www.googleapis.com/auth/drive.readonly Visualizzare e scaricare tutti i tuoi file di Google Drive. Con restrizioni

La colonna Utilizzo nella tabella indica la sensibilità di ogni ambito, in base alle seguenti definizioni:

  • Non sensibile: questi ambiti offrono l'ambito minimo di accesso all'autorizzazione e richiedono solo la verifica dell'app di base. Per informazioni su questo requisito, consulta Inviare l'app per la verifica.

  • Sensibili: questi ambiti consentono di accedere a specifici dati utente Google autorizzati dall'utente per la tua app. Devi eseguire un'ulteriore verifica dell'app. Per informazioni su questo requisito, consulta i requisiti relativi all'ambito sensibile e limitato.

  • Limitato: questi ambiti offrono accesso ampio ai dati utente di Google e richiedono l'esecuzione di una procedura di verifica dell'ambito con restrizioni. Per informazioni su questo requisito, consulta le Norme relative ai dati utente dei servizi API di Google e i requisiti aggiuntivi per ambiti API specifici. Se archivi dati relativi all'ambito con restrizioni sui server (o li trasmetti), devi eseguire una valutazione della sicurezza.

Se la tua app richiede l'accesso a qualsiasi altra API di Google, puoi aggiungere anche questi ambiti. Per ulteriori informazioni sugli ambiti delle API di Google, consulta la pagina relativa all'utilizzo di OAuth 2.0 per accedere alle API di Google.

Per ulteriori informazioni su specifici ambiti OAuth 2.0, consulta Ambiti OAuth 2.0 per le API di Google.