Visualizzare, creare e modificare le attività del corso in Classroom
Cosa posso creare con gli endpoint CourseWork nell'API Classroom?
Gli endpoint consentono agli sviluppatori di visualizzare e gestire il lavoro di una classe. Nello specifico, puoi eseguire tutte le seguenti operazioni:
- Visualizzare i compiti e le domande (collettivamente denominati
CourseWork) per un utente - Crea, modifica ed elimina
CourseWork - Allega materiali (file di Drive, video di YouTube, link) a
CourseWork - Modificare lo stato di un lavoro inviato da uno studente (ad esempio consegna, restituzione, recupero)
- Impostare il voto per un compito inviato
- Allegare materiali (file di Drive, video di YouTube, link) ai compiti degli studenti
Alcuni casi d'uso di esempio per CourseWork:
- I registri, i SIS o i sistemi di generazione di report possono sincronizzare i compiti e i voti da Classroom alle loro applicazioni, eliminando il trasferimento manuale dei dati.
- Le applicazioni di apprendimento possono creare nuovi compiti che vengono visualizzati nello stream del corso. Man mano che gli studenti completano i loro lavori, le applicazioni possono consegnarli, impostare i voti, allegare i lavori degli studenti e archiviarli nelle cartelle Drive appropriate.
- Gli utenti insegnanti possono creare compiti con allegati di componenti aggiuntivi dal tuo sito web o dalla tua applicazione.
- Gli utenti studenti possono consegnare i compiti con gli allegati del tuo componente aggiuntivo.
Quali autorizzazioni ha bisogno l'applicazione per creare o modificare assegnazioni?
In genere, un'applicazione può modificare solo il lavoro che crea. In altre parole, tutte le richieste dell'API di mutazione dei compiti devono utilizzare lo stesso ID progetto Google Cloud memorizzato al momento della creazione del compito.
I componenti aggiuntivi di Google Classroom fanno eccezione a questa regola. Un progetto Cloud può accedere o modificare annunci, compiti o materiali che contengono uno o più allegati dei componenti aggiuntivi. Un progetto Cloud può anche consegnare, recuperare o restituire un compito con uno o più allegati dei componenti aggiuntivi.
Le richieste API richiedono anche gli ambiti utente corretti. Gli insegnanti possono visualizzare i compiti, creare compiti, allegare link ai compiti inviati e impostare i voti di invio. Gli studenti possono visualizzare i compiti, allegare link ai record dei compiti, consegnare e ritirare i contenuti inviati. Gli amministratori di dominio possono visualizzare CourseWork, ma non dispongono di autorizzazioni di scrittura.
Quali tipi di elementi può allegare la mia applicazione ai compiti o ai contenuti inviati?
L'API supporta l'allegazione di file di Drive, video di YouTube e link. L'allegazione di moduli Google nativi non è ancora supportata.
Gli utenti finali sanno che un compito in Classroom è stato creato dalla mia applicazione?
Sì. L'interfaccia utente di Classroom identifica i compiti creati esternamente utilizzando il nome del prodotto del progetto Google Cloud che ha creato il lavoro. Gli utenti possono segnalare il lavoro creato esternamente come indesiderato, nonché disconnettere l'applicazione che l'ha creata, revocando le credenziali inviate all'applicazione dall'utente.
Pulsante Condividi di Classroom e altre integrazioni
Ho già eseguito l'integrazione con il pulsante di condivisione di Classroom. Posso modificare un compito creato utilizzando il pulsante di condivisione?
Non ancora. Per modificare un'assegnazione, la richiesta deve utilizzare lo stesso progetto Google Cloud che ha creato l'assegnazione.
Posso rispondere alle domande nell'API?
Non ancora. Puoi creare e modificare le domande.
Componenti aggiuntivi di Classroom
Configurazione progetto
Posso convertire un progetto Google Cloud privato utilizzato durante lo sviluppo in un progetto pubblico che posso utilizzare in produzione?
Non puoi convertire un progetto Google Cloud privato in uno pubblico. Sono necessari due progetti distinti, uno per lo sviluppo e l'altro per la produzione.
Un singolo progetto Google Cloud può avere due schede di Google Workspace Marketplace?
No. Non puoi creare due schede di Google Workspace Marketplace per un singolo progetto Google Cloud.
Tuttavia, è possibile raggruppare i componenti aggiuntivi. In questo modo, una singola scheda di Google Workspace Marketplace può rappresentare più componenti aggiuntivi. L'installazione da una scheda di questo tipo comporterà l'installazione di tutti i componenti aggiuntivi del pacchetto contemporaneamente. Gli utenti dovranno acconsentire a tutti gli ambiti necessari per i componenti aggiuntivi in bundle durante l'autorizzazione.
Un client OAuth di un altro progetto Google Cloud può essere riutilizzato con un progetto Google Cloud per i componenti aggiuntivi di Classroom?
No, un client OAuth di un progetto Google Cloud diverso dal progetto Google Cloud del componente aggiuntivo Classroom non può funzionare. I token di accesso generati da un altro progetto Google Cloud vengono rifiutati dall'API Classroom. Devi creare un client OAuth separato per il progetto del componente aggiuntivo.
Esperienza utente
Il nostro logo non si adatta bene a un piccolo quadrato. Quali opzioni di dimensioni sono disponibili per i loghi nella barra del titolo dell'iframe?
La barra del titolo dell'iframe è stata progettata per supportare solo un logo quadrato di 32 x 32. Questa scelta è stata effettuata sulla base della forma della favicon che le aziende utilizzano sui loro siti web. Abbiamo intenzione di utilizzare lo stesso logo nello spazio per garantire la coerenza del brand.
Domini
Tutti gli insegnanti e gli studenti nello stesso dominio hanno accesso a un componente aggiuntivo installato?
Gli amministratori scolastici hanno la possibilità di stabilire quali insegnanti possono visualizzare un componente aggiuntivo installato. I componenti aggiuntivi di Classroom sono utilizzabili solo dagli utenti con una licenza Teaching & Learning o Education Plus.
In che modo gli amministratori di dominio interagiscono con i componenti aggiuntivi?
Gli amministratori di dominio (amministratori) stabiliscono chi può utilizzare il componente aggiuntivo. Possono installare un componente aggiuntivo per un intero dominio utilizzando l'opzione di installazione per gli amministratori. Se il componente aggiuntivo può essere installato singolarmente, tieni presente che la maggior parte degli amministratori gestisce una lista consentita di componenti aggiuntivi, che possono essere installati dagli insegnanti per gli utenti inclusi nell'elenco. Un amministratore potrebbe anche scegliere di installare singolarmente il componente aggiuntivo a scopo di test.
Gli amministratori potrebbero essere interessati anche alle statistiche di utilizzo relative al tuo componente aggiuntivo. Se supportato dal tuo prodotto, valuta la possibilità di fornire statistiche sull'utilizzo dei componenti aggiuntivi in una visualizzazione amministratore sul tuo sito.
API
Qual è un modo affidabile per sapere se la pagina del partner è caricata all'interno di un iframe o di una scheda popout?
Al momento non esiste un metodo per distinguerli.
Quali elementi di lavoro assegnabili ricevono un iframe di revisione dei lavori degli studenti?
L'iframe della revisione del lavoro dello studente viene fornito solo per gli allegati di tipo attività.
Chiama il metodo courses.courseWork.getAddOnContext per scoprire se il tipo di post supporta il lavoro degli studenti. Il campo supportsStudentWork può essere true solo per un tipo di post che è un'attività.
Un allegato di un componente aggiuntivo può accedere all'elemento dello stream a cui è collegato?
Sì. Puoi get o patch qualsiasi Announcement, CourseWork o
CourseWorkMaterial che contiene almeno uno dei tuoi allegati del componente aggiuntivo.
Puoi reclaim, return o turnIn un CourseWork StudentSubmission.
Single Sign-On
Gli studenti che utilizzano i badge Clever o Classlink per accedere al Chromebook possono utilizzare l'accesso con Google?
Sì, può continuare a usare Accedi con Google.
Tutti gli studenti hanno un indirizzo email formato correttamente, anche se non hanno accesso a Gmail?
Ogni utente di Google Workspace for Education ha un'identità Google, indipendentemente dal fatto che abbia accesso a Gmail. Le identità sono rappresentate da un indirizzo email. L'identità e l'accesso a un determinato servizio Google (incluso Gmail) sono distinti. Pertanto, anche se Gmail è disattivato, gli studenti possono accedere con il loro indirizzo email.
Un amministratore scolastico deve preapprovare l'app per consentire agli studenti di accedere?
Prima che un componente aggiuntivo possa essere installato, gli amministratori di dominio devono inserirlo nella lista consentita. Facoltativamente, gli amministratori di dominio possono installare un componente aggiuntivo per tutti gli utenti all'interno del dominio o di un'unità organizzativa.
Feedback e domande generali
Come faccio a inviare richieste di funzionalità o problemi relativi alle richieste?
Puoi inviare, visualizzare e votare le richieste di funzionalità nel nostro Issue Tracker pubblico.
Come faccio a sapere quando sono disponibili nuove funzionalità nell'API Classroom?
Gli aggiornamenti all'API vengono pubblicati sulla pagina delle note di rilascio, sul nostro forum degli sviluppatori e sullo strumento pubblico di segnalazione dei problemi.
Utilizzo l'API Classroom. Come faccio a porre domande tecniche?
Pubblica le tue domande su Stack Overflow con il tag google-classroom.