Questo documento contiene informazioni su autorizzazione e autenticazione specifiche per l'API Google Slides. Prima di leggere questo documento, assicurati di leggere le informazioni generali sull'autenticazione e l'autorizzazione di Google Workspace in 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 le informazioni visualizzate agli utenti e ai revisori delle app e registrare la tua app in modo da poterla pubblicare in un secondo momento.
Ambiti dell'API Slides
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 per lavorare con i dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.
Quando l'app viene installata, a un utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più specifico possibile ed evitare di richiedere ambiti non necessari per la tua app. 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 alle funzionalità specifiche necessarie a un'app.
L'API Slides supporta i seguenti ambiti:
| Codice ambito | Descrizione | Utilizzo |
|---|---|---|
https://www.googleapis.com/auth/presentations |
Visualizza, modifica, crea ed elimina tutte le tue presentazioni Google Slides. | Sensibile |
https://www.googleapis.com/auth/presentations.readonly |
Visualizza tutte le tue presentazioni Google Slides. | Sensibile |
https://www.googleapis.com/auth/spreadsheets |
Visualizza, modifica, crea ed elimina tutti i tuoi fogli di lavoro Google Sheets. | Sensibile |
https://www.googleapis.com/auth/spreadsheets.readonly |
Visualizza tutti i tuoi fogli di lavoro Google Sheets. | 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 |
Visualizza, modifica, crea ed elimina tutti i tuoi file di Google Drive. | Con restrizioni |
https://www.googleapis.com/auth/drive.readonly |
Visualizza e scarica tutti i tuoi file di Google Drive. | Con restrizioni |
La colonna Utilizzo della tabella indica la sensibilità di ogni ambito, in base alle seguenti definizioni:
Non sensibile: questi ambiti forniscono l'ambito più piccolo di accesso all'autorizzazione e richiedono solo la verifica app di base. Per informazioni su questo requisito, vedi Inviare l'app per la verifica.
Sensibile: questi ambiti forniscono l'accesso a dati utente di Google specifici autorizzati dall'utente per la tua app. Richiedono una verifica aggiuntiva dell'app. Per informazioni su questo requisito, vedi Requisiti per gli ambiti sensibili e con restrizioni.
Con restrizioni: questi ambiti forniscono un ampio accesso ai dati utente di Google e richiedono una procedura di verifica degli ambiti con restrizioni. Per informazioni su questo requisito, vedi Norme relative ai dati utente dei servizi API di Google e Requisiti aggiuntivi per ambiti API specifici. Se memorizzi (o trasmetti) dati di ambiti con restrizioni sui server, devi sottoporti 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 sugli ambiti OAuth 2.0 specifici, vedi Ambiti OAuth 2.0 per le API di Google.
Argomenti correlati
- Scegliere gli ambiti dell'API Google Sheets
- Scegliere gli ambiti dell'API Google Drive
- Centro assistenza per la verifica di app OAuth
- Domande frequenti sulla verifica app OAuth