Scegli gli ambiti API di Google Classroom

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.