Scegli gli ambiti API di Google Classroom

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.

Se la tua applicazione pubblica utilizza ambiti che consentono l'accesso a determinati dati utente, deve completare un processo di verifica. Se vedi app non verificata sullo schermo quando testi l'applicazione, devi inviare una richiesta di verifica per rimuoverla. Scopri di più sulle app non verificate e leggi le risposte alle domande frequenti sulla verifica delle app nel Centro assistenza.

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.