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 consente agli amministratori 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. Puoi eseguire i test di conformità prima di contattare il team di Classroom per determinare quanto 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 ai test ed eseguirli
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 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 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 |
|---|---|
| Teachers: 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. |
| Teachers: GetAllTeachers with email filter | 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. |
| Classes: GetClassesForTeacher | L'endpoint /teachers/{teacher_sourced_id}/classes viene chiamato con un parametro di query filter utilizzato per filtrare in base ai corsi attivi. |
| Students: 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 (Optional / Cleanup): Delete and 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.