Questo documento contiene informazioni su autorizzazione e autenticazione specifiche per l'API Google Classroom. 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 API Classroom
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.
L'API Classroom supporta i seguenti ambiti:
| Ambiti | Significato |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Visualizzare, creare e aggiornare gli allegati del progetto Google Cloud richiedente agli elementi del flusso nei corsi che insegni in Google Classroom. |
https://www.googleapis.com/auth/classroom.addons.student
|
Visualizzare e aggiornare gli allegati del progetto Google Cloud richiedente agli elementi del flusso in Google Classroom. |
https://www.googleapis.com/auth/classroom.announcements
|
Visualizzare e gestire gli annunci in Google Classroom. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Visualizzare gli annunci in Google Classroom. |
https://www.googleapis.com/auth/classroom.courses
|
Visualizzare, modificare, creare ed eliminare definitivamente i tuoi corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Visualizza i tuoi corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Visualizzare, creare e modificare i materiali del corso tra cui compiti, domande e voti. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Visualizzare i lavori del corso e i voti in Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Gestire i lavori e i voti degli studenti nei corsi di Google Classroom in cui insegni e visualizzare i lavori e i voti dei corsi che amministri. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Visualizzare i lavori e i voti del corso degli studenti nei corsi di Google Classroom in cui insegni o che amministri. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Visualizzare, modificare e creare materiali dei lavori del corso in Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Visualizzare tutti i materiali dei lavori del corso per i tuoi corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Visualizzare i tuoi sorveglianti Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Visualizzare e gestire i sorveglianti per gli studenti dei tuoi corsi Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Visualizzare i sorveglianti degli studenti dei tuoi corsi Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Visualizza gli indirizzi email delle persone delle tue classi. |
https://www.googleapis.com/auth/classroom.profile.photos
|
Visualizza le foto del profilo delle persone delle tue classi. |
https://www.googleapis.com/auth/classroom.push-notifications
|
Ricevere notifiche relative ai dati Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters
|
Gestire gli elenchi delle classi di Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Visualizzare gli elenchi delle classi di Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Visualizzare i lavori del corso e i voti in Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Visualizzare i lavori e i voti del corso degli studenti nei corsi di Google Classroom in cui insegni o che amministri. |
https://www.googleapis.com/auth/classroom.topics
|
Visualizzare, creare e modificare argomenti in Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Visualizzare argomenti in Google Classroom. |