Questo documento contiene informazioni su autorizzazione e autenticazione specifiche dell'API Google Docs. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo Informazioni 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 vengono visualizzate dagli utenti e dai revisori delle app e registra la tua app in modo da poterla pubblicare in un secondo momento.
Ambiti dell'API Docs
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 utilizzare i dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.
Quando l'app viene installata, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più ristretto possibile ed evitare di richiedere ambiti che la tua app non richiede. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti chiaramente.
Se possibile, ti consigliamo di utilizzare ambiti non sensibili, in quanto concedono l'ambito di accesso per file e limitano l'accesso a funzionalità specifiche necessarie a un'app.
L'API Docs supporta i seguenti ambiti:
| Codice ambito | Descrizione | Utilizzo |
|---|---|---|
https://www.googleapis.com/auth/documents |
Visualizzare, modificare, creare ed eliminare tutti i tuoi documenti Google. | Sensibile |
https://www.googleapis.com/auth/documents.readonly |
Visualizzare tutti i tuoi documenti Google. | Sensibile |
https://www.googleapis.com/auth/drive.file |
Visualizzare, modificare, creare ed eliminare soltanto i file di Google Drive specifici che usi 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 file di Google Drive. | Con restrizioni |
La colonna Utilizzo della tabella indica la sensibilità di ogni ambito, in base alle seguenti definizioni:
Non sensibili: questi ambiti forniscono il più piccolo ambito di accesso all'autorizzazione e richiedono solo la verifica di base dell'app. Per informazioni su questo requisito, vedi Invio dell'app per la verifica.
Sensibili: questi ambiti forniscono l'accesso a dati utente Google specifici autorizzati dall'utente per la tua app. Richiedono di superare una verifica aggiuntiva dell'app. Per informazioni su questo requisito, consulta Requisiti relativi agli ambiti sensibili e con limitazioni.
Con restrizioni: questi ambiti forniscono un ampio accesso ai dati utente di Google e richiedono di superare una procedura di verifica degli ambiti con restrizioni. Per informazioni su questo requisito, consulta le Norme relative ai dati utente dei servizi API di Google e i Requisiti aggiuntivi per gli ambiti API specifici. Se memorizzi (o trasmetti) dati con ambiti con restrizioni sui server, devi sottoporsi a una valutazione della sicurezza.
Se la tua app richiede l'accesso ad altre API di Google, puoi aggiungere anche questi ambiti. Per ulteriori informazioni sugli ambiti delle API di Google, vedi Utilizzare OAuth 2.0 per accedere alle API di Google.
Per ulteriori informazioni su ambiti OAuth 2.0 specifici, vedi Ambiti OAuth 2.0 per le API di Google.
Argomenti correlati
- Scegliere gli ambiti dell'API Google Drive
- Centro assistenza per la verifica di app OAuth
- Domande frequenti sulla verifica app OAuth