I partner SIS interessati possono utilizzare i test di conformità su GitHub per determinare se il loro prodotto soddisfa i requisiti di utilizzo di OneRoster di Google Classroom.
Accedere ed eseguire i test
Per eseguire i test, devi disporre di quanto segue:
- URL del token per recuperare le credenziali OAuth 2.0
- URL di 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 interessati dei SIS un modo per determinare se il loro prodotto soddisfa i requisiti di utilizzo di OneRoster di Google e per ridurre al minimo gli errori che gli utenti potrebbero riscontrare quando utilizzano le integrazioni dei SIS in Classroom. Leggi i seguenti suggerimenti sui test. In GitHub, ogni test ha un titolo a cui viene fatto riferimento nei cursori. Tieni presente che i cursori possono contribuire a chiarire le domande, ma non si tratta di un elenco completo dei test. Assicurati di aver eseguito tutti i test forniti su GitHub.
| Test | Indicatori |
|---|---|
| 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 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 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 chiami PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | La chiamata all'API non deve restituire un errore se è incluso un titolo lungo del compito. Il test include un titolo del compito con più di 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 ed esegui 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. |
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.1 di Google. Scarica o acquisisci uno screenshot del report generato da condividere con il team di Google Classroom.
Assistenza
In caso di domande o dubbi, invia un'email all'indirizzo classroom-sis-external@google.com.