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 piattaforme SIS che soddisfano i requisiti OneRoster specificati da Google.
La partnership con Classroom offre agli amministratori la possibilità di collegare i corsi 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 acquisire familiarità 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 Google Classroom live per creare e convalidare un'integrazione. Gli utenti di test idonei devono disporre dell'edizione Plus di Google Workspace for Education. Se non hai accesso amministrativo 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. Il tuo dominio riceverà il provisioning di 10 licenze Google Workspace for Education Plus.
Accedere ai test ed eseguirli
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/v1p1 - ID client
- Client secret
- Un indirizzo email dell'insegnante
Puoi eseguire i test utilizzando Google Colab o Jupyter Notebook. Sia Colab che Jupyter Notebook ti consentono di eseguire tutti i test contemporaneamente. In questo modo, puoi generare i risultati del test da condividere con il team di Google Classroom.
Requisiti del SIS e comportamento previsto
I test definiti da Google esistono per 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 viene fatto riferimento nei puntatori. Tieni presente che i suggerimenti possono aiutarti a chiarire le domande, ma non si tratta di un elenco esaustivo dei test. Assicurati di aver eseguito tutti i test forniti in GitHub.
| Test | Puntatori |
|---|---|
| Insegnanti: 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 alle classi attive. |
| 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 chiami il numero PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | La chiamata API non deve restituire un errore se è inclusa una lunghezza del titolo dell'assegnazione lunga. Il test include un titolo dell'attività di oltre 100 caratteri. |
| Risultato: Modifica | Dovrebbe essere possibile impostare score su un valore maggiore di resultValueMax per rappresentare il credito extra. |
| Risultato: Elimina | L'endpoint DELETE /results/{result_sourced_id} è obbligatorio. |
| LineItem (facoltativo / pulizia): elimina e ottieni | L'endpoint DELETE /lineItems/{line_item_sourced_id} non è obbligatorio. È facoltativo e viene utilizzato per la pulizia dei dati. L'endpoint GET /classes/{class_sourced_id}/lineItems successivo è facoltativo e verifica che l'elemento pubblicitario sia stato eliminato. |
Condividere i risultati del test con il team di Google Classroom
Dopo aver eseguito i test, viene generato un report completo con i risultati di ciascun 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 il team di Google Classroom.
Assistenza
Invia un'email all'indirizzo classroom-sis-external@google.com per qualsiasi domanda.