Questo documento contiene informazioni di 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 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 di 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 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 Classroom supporta i seguenti ambiti:
Ambiti | Significato |
---|---|
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 in Google Classroom. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Visualizzare i corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Visualizzare, creare e modificare elementi delle attività del corso, inclusi 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 le attività e i voti degli studenti nei corsi di Google Classroom in cui insegni e visualizzare le attività e i voti dei corsi che gestisci. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Visualizzare le attività e i voti 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
|
Visualizza 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 tutori di Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Visualizzare e gestire i tutori degli studenti nei tuoi corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Visualizzare i tutori degli studenti nei tuoi corsi di Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Visualizzare gli indirizzi email delle persone dei tuoi corsi. |
https://www.googleapis.com/auth/classroom.profile.photos
|
Visualizzare le foto del profilo delle persone dei tuoi corsi. |
https://www.googleapis.com/auth/classroom.push-notifications
|
Ricevi notifiche sui tuoi dati di 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 le attività e i voti 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 gli argomenti in Google Classroom. |