Scegli gli ambiti API di Google Classroom

Questo documento contiene informazioni su autorizzazione e autenticazione specifiche dell'API Google Classroom. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo Scopri di più su autenticazione e autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configurare la schermata per il consenso OAuth e scegliere gli ambiti per definire le informazioni da mostrare agli utenti e ai revisori dell'app e registrare la tua 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 di lavorare con i dati di Google Workspace, inclusi i dati degli Account Google degli utenti.

Quando l'app è installata, a un utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più limitato possibile ed evitare di richiedere ambiti non necessari per la tua app. Gli utenti acconsentono più facilmente all'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 per lo streaming di elementi nei corsi in cui insegni in Google Classroom.
https://www.googleapis.com/auth/classroom.addons.student	Visualizzare e aggiornare gli allegati del progetto Google Cloud che effettua la richiesta per trasmettere gli elementi 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 corsi di Google Classroom.
https://www.googleapis.com/auth/classroom.courses.readonly	Visualizzare 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 e i voti del corso 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 tutori di Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Visualizzare e gestire i tutori per gli studenti nei tuoi corsi di 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 che partecipano ai 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 degli studenti 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 gli argomenti in Google Classroom.