Google Classroom supporta l'importazione degli elenchi degli studenti e la sincronizzazione del registro per una serie di sistemi informatici per gli studenti (SIS) conformi a OneRoster. Google collabora con piattaforme SIS che soddisfano i requisiti OneRoster specificati da Google.
Figura 1. Quando i sistemi informatici per gli studenti (SIS) collaborano con Classroom, gli amministratori possono scegliere il SIS nel menu a discesa.
Percorso di onboarding dei partner SIS
Di seguito è riportata una breve panoramica del percorso di onboarding dei partner SIS:
Esprimi interesse: se ti interessa collaborare con Classroom, compila il modulo di interesse.
Esplora ed esegui i test di conformità: per capire se il tuo SIS è pronto per l'integrazione con Classroom, puoi esaminare i test di conformità per familiarizzare con i requisiti di Google. Hai la possibilità di eseguire i test di conformità prima di esprimere interesse al team di Google Classroom per determinare quanto il tuo prodotto soddisfa i requisiti di Google.
Contatta il team di Google Classroom: il team di Classroom ti contatterà dopo l'invio del modulo di interesse se esiste un'opportunità di partnership.
Condividi i risultati dei test e crea l'integrazione end-to-end: una volta che il team di Classroom ti avrà contattato, condividi i risultati dei test di conformità. Il tuo team collaborerà con Google per convalidare e completare l'integrazione.
Test di conformità
I test di conformità definiti da Google esistono per fornire ai partner SIS un modo per determinare se il loro prodotto soddisfa i requisiti di consumo di OneRoster di Google e per ridurre al minimo gli errori che gli utenti potrebbero riscontrare durante l'utilizzo delle integrazioni SIS in Classroom. I test sono pubblicati su GitHub.
Accedi ed esegui i test
Per eseguire i test, devi disporre di quanto segue:
- URL del token per recuperare le credenziali OAuth 2.0
- URL OneRoster che termina con
/ims/oneroster/v1p2 - ID client
- Client secret
- Un indirizzo email dell'insegnante
Puoi eseguire i test utilizzando Google Colab o il notebook Jupyter. Sia il notebook Colab che il notebook Jupyter ti consentono di eseguire tutti i test contemporaneamente. In questo modo, potrai generare i risultati dei test da condividere con il team di Google Classroom.
Requisiti e comportamento previsto
Leggi i seguenti suggerimenti sui test. In GitHub, ogni test ha un titolo a cui viene fatto riferimento nella tabella. Questi suggerimenti possono aiutare a chiarire le domande, ma non costituiscono un elenco completo dei test. Assicurati di aver eseguito tutti i test forniti in GitHub per garantire la conformità.
| Test | Puntatori |
|---|---|
| Teachers: GetAllTeachers | L'endpoint GET /teachers viene chiamato con un parametro di query limit. Nei test successivi, questo parametro viene utilizzato per garantire che il prodotto possa supportare una dimensione della pagina di 10.000. |
| Insegnanti: GetAllTeachers con filtro email | L'endpoint GET /teachers viene chiamato con un parametro di query filter utilizzato per filtrare in base all'indirizzo email di un insegnante. Verrà utilizzato l'indirizzo email dell'insegnante che hai fornito nella sezione Credenziali dei test. |
| Corsi: GetClassesForTeacher | L'endpoint /teachers/{teacher_sourced_id}/classes viene chiamato con un parametro di query filter utilizzato per filtrare in base ai corsi attivi. |
| Studenti: GetStudentsForClass | Viene chiamato l'endpoint GET /classes/{class_sourced_id}/students. L'email dello studente deve essere restituita nella risposta. |
| GetGradingPeriodsForTerm | Il supporto dei periodi di valutazione viene testato utilizzando term_sourced_id. Questo term_sourced_id viene utilizzato per recuperare i periodi di valutazione nel trimestre chiamando l'endpoint GET /terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | I periodi di valutazione non sono obbligatori quando si chiama PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | La chiamata API non deve restituire un errore se è incluso un titolo del compito lungo. Il test include una lunghezza del titolo del compito di oltre 100 caratteri. |
| Risultato: Modifica | Dovrebbe essere possibile impostare score su un valore maggiore di resultValueMax per rappresentare un credito extra. |
| Risultato: Elimina | L'endpoint DELETE /results/{result_sourced_id} è obbligatorio. |
| LineItem (facoltativo/pulizia): Delete e Get | L'endpoint DELETE /lineItems/{line_item_sourced_id} non è obbligatorio. È facoltativo e viene utilizzato per la pulizia dei dati. Anche l'endpoint GET /classes/{class_sourced_id}/lineItems successivo è facoltativo e verifica che l'elemento pubblicitario sia stato eliminato. |
Condividi i risultati dei test con il team di Google Classroom
Dopo aver eseguito i test, viene generato un report completo con i risultati di ogni test. I risultati vengono utilizzati per determinare se il tuo prodotto soddisfa i requisiti di consumo di OneRoster 1.2 di Google. Scarica o acquisisci uno screenshot del report generato per condividerlo con i tuoi contatti del team di Google Classroom.
Ottieni un dominio demo per sviluppatori
Una volta che i risultati dei test di conformità sono stati esaminati dal team di Google Classroom, un dominio demo per sviluppatori ti consente di convalidare l'integrazione end-to-end. Tieni presente che il superamento dei test di conformità non garantisce l'approvazione della partnership o dell'integrazione.
Un dominio demo per sviluppatori è un ambiente Google Classroom di test attivo che ti aiuta a verificare che l'integrazione funzioni come previsto. Completa i passaggi per ottenere un dominio demo per sviluppatori e richiedere un upgrade del dominio demo. L'upgrade esegue il provisioning del tuo dominio con 10 licenze Google Workspace for Education Plus. Queste licenze devono essere assegnate agli utenti di test nel tuo dominio sviluppatore in modo che possano testare le funzionalità di integrazione del SIS in Classroom.
Domande frequenti
1. Quale modello di dati si aspetta Classroom dal SIS?
Classroom rispetta la specifica OneRoster 1.2. Se il tuo SIS utilizza una struttura dei dati diversa, potresti riscontrare un comportamento imprevisto. Ad esempio, se il tuo sistema supporta una relazione nidificata tra periodi di valutazione e categorie di voto, questa non rientra nella specifica OneRoster 1.2 e devi testare l'integrazione in modo approfondito per garantire la compatibilità corretta.
2. Quali voti e stati dei compiti vengono esportati nel SIS?
Nel SIS vengono esportati solo i voti restituiti o i contenuti inviati contrassegnati come "Mancante" o "Esonerato". I voti provvisori non vengono esportati.
3. Che cosa succede all'elemento pubblicitario nel SIS se un compito viene eliminato in Classroom?
L'eliminazione di un compito in Classroom non comporta l'eliminazione della voce corrispondente nel SIS. In questo modo si evitano la perdita accidentale di dati e le eliminazioni a cascata involontarie.