Google Classroom supporta la sincronizzazione del registro e l'importazione degli elenchi per una serie di sistemi informatici per gli studenti (SIS) conformi a OneRoster. Google collabora con le piattaforme SIS che soddisfano i requisiti OneRoster specificati da Google.
La partnership con Classroom offre agli amministratori la possibilità di collegare le classi di Classroom al tuo SIS.
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 sviluppo dei partner SIS
Se ti interessa collaborare con Classroom, compila il modulo di interesse.
Il team di Classroom ha creato una serie di test di conformità che i partner SIS interessati possono utilizzare per familiarizzare con i requisiti di Google. Hai la possibilità di eseguire i test di conformità prima di contattare il team di Classroom per determinare in che misura il tuo prodotto soddisfa i requisiti di Google.
Ottenere un dominio demo per sviluppatori
Potresti voler accedere a un'istanza live di Google Classroom per creare e convalidare un'integrazione. Gli utenti di test idonei hanno bisogno della versione Plus di Google Workspace for Education. Se non hai accesso amministratore a un dominio Google Workspace for Education con queste licenze, completa i passaggi per ottenere un dominio di test per sviluppatori e richiedere un upgrade del dominio demo. Al tuo dominio verranno fornite 10 licenze Google Workspace for Education Plus.
Accedere ed eseguire i test
Per eseguire i test, devi disporre di:
- URL del token per recuperare le credenziali OAuth 2.0
- URL di OneRoster che termina con
/ims/oneroster/v1p2 - ID client
- Client secret
- Un indirizzo email dell'insegnante
Puoi eseguire i test utilizzando Google Colab o Jupyter Notebook. Sia Colab sia Jupyter Notebook ti consentono di eseguire tutti i test contemporaneamente. In questo modo puoi generare i risultati dei test da condividere con il team di Google Classroom.
Requisiti e comportamento previsto del SIS
I test definiti da Google hanno lo scopo di fornire ai partner SIS interessati 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 quando utilizzano le integrazioni SIS in Classroom. Leggi i seguenti suggerimenti sui test. In GitHub, ogni test ha un titolo a cui si fa riferimento nei suggerimenti. Tieni presente che i suggerimenti possono aiutarti a chiarire le domande, ma non sono un elenco completo dei test. Assicurati di aver eseguito tutti i test forniti in GitHub.
| Test | Suggerimenti |
|---|---|
| Insegnanti: GetAllTeachers | L'endpoint GET /teachers viene chiamato con un parametro di query limit. Nei test successivi, questo parametro viene utilizzato per assicurarsi che il tuo 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. |
| Classi: GetClassesForTeacher | L'endpoint /teachers/{teacher_sourced_id}/classes viene chiamato con un parametro di query filter utilizzato per filtrare in base alle classi attive. |
| Studenti: GetStudentsForClass | Viene chiamato l'endpoint GET /classes/{class_sourced_id}/students. L'indirizzo email dello studente deve essere restituito nella risposta. |
| GetGradingPeriodsForTerm | Il supporto per i 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 è inclusa una lunghezza del titolo del compito lunga. Il test include una lunghezza del titolo del compito di oltre 100 caratteri. |
| Result: Edit | Dovrebbe essere possibile impostare score su un valore maggiore di resultValueMax per rappresentare il credito extra. |
| Result: Delete | 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 della riga sia stato eliminato. |
Condividere 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. Questi test 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 da condividere con i tuoi contatti del team di Google Classroom.