Scegli gli ambiti API di Google Classroom

Questo documento contiene informazioni sull'autorizzazione e sull'autenticazione specifiche dell'API Google Classroom. Prima di leggere questo documento, assicurati di leggere le informazioni generali sull'autenticazione e l'autorizzazione di Google Workspace in Informazioni sull'autenticazione e l'autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configura la schermata per il consenso OAuth e scegli gli ambiti per definire le informazioni visualizzate dagli utenti e dai revisori delle app e registrare l'app in modo da poterla pubblicare in un secondo momento.

Ambiti dell'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 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.

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 dello stream 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 dello stream in Google Classroom.
https://www.googleapis.com/auth/classroom.announcements	Visualizzare e gestire annunci in Google Classroom.
https://www.googleapis.com/auth/classroom.announcements.readonly	Visualizzare annunci in Google Classroom.
https://www.googleapis.com/auth/classroom.courses	Visualizzare, modificare, creare ed eliminare definitivamente i corsi di 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 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 del corso e i voti degli studenti nei corsi di Google Classroom in cui insegni e visualizzare i lavori del corso e i voti per i corsi che amministri.
https://www.googleapis.com/auth/classroom.coursework.students.readonly	Visualizzare i lavori del corso e i voti degli studenti nei Google Classroom corsi 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 tutori di Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Visualizzare e gestire i tutori degli studenti nei corsi di Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	Visualizzare i tutori degli studenti nei 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	Ricevere notifiche sui dati di Google Classroom.
https://www.googleapis.com/auth/classroom.rosters	Gestire gli elenchi di Google Classroom.
https://www.googleapis.com/auth/classroom.rosters.readonly	Visualizzare gli elenchi 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 del corso e i voti degli studenti nei Google Classroom corsi 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.