Verificare che il SIS soddisfi i requisiti di Google Classroom

Per integrare il SIS con Classroom, verifica che il tuo prodotto soddisfi i requisiti di partnership di Classroom eseguendo l'insieme di test di conformità fornito.

Accedere ed eseguire i test

Puoi accedere ai test di conformità su GitHub. Per eseguire i test, devi avere quanto segue:

  • URL del token per recuperare le credenziali OAuth 2.0
  • Un URL dell'elenco che termina con /ims/oneroster/v1p1
  • ID client
  • Client secret
  • L'indirizzo email di un insegnante

La suite di test è composta da tre sezioni:

  • Sincronizzazione dei voti di base
  • Categorie di voto
  • Periodi di valutazione

Puoi eseguire i test utilizzando Google Colab o il blocco note Jupyter. I blocchi note Colab e Jupyter 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 servono a mantenere la coerenza e ridurre al minimo gli errori che gli utenti potrebbero riscontrare durante l'utilizzo delle integrazioni dei SIS con Classroom. Leggi attentamente i seguenti suggerimenti sui test. In GitHub, ogni test è contrassegnato con @title. Questi titoli sono indicati nei puntatori.

  1. Tieni presente quanto segue in merito alla sezione Sincronizzazione dei voti di base:

    • Nel test GetAllTeachers, l'endpoint GET /teachers viene chiamato con un parametro di query limit=. Nei test successivi, questo parametro viene utilizzato per verificare che il tuo prodotto possa supportare una dimensione di pagina pari a 10.000.

    • Nel test GetAllTeachers with email filter, l'endpoint GET /teachers viene richiamato con un parametro di query filter= utilizzato per filtrare in base all'indirizzo email dell'insegnante. Devi specificare l'indirizzo email di un insegnante quando esegui i test.

    • Nel test GetClassesForTeacher, l'endpoint /teachers/{teacher_sourced_id}/classes viene chiamato con un parametro di query filter= utilizzato per filtrare in base alle classi attive.

    • Nel test GetStudentsForClass viene chiamato l'endpoint GET /classes/{class_sourced_id}/students?limit=10000. L'indirizzo email dello studente deve essere restituito nella risposta.

    • Nel test PutLineItem Create, le categorie di voto o i periodi di valutazione non sono obbligatori quando chiami PUT /lineItems/{line_item_sourced_id}.

    • Nel test PutLineItem Edit, la chiamata API non deve restituire un errore se è incluso un titolo di compito lungo. Il test include un titolo del compito di più di 100 caratteri.

    • Nel test PutResult Edit dovrebbe essere possibile impostare score su un valore maggiore di resultValueMax per rappresentare il merito aggiuntivo.

    • L'endpoint DELETE /results/{result_sourced_id} è obbligatorio e testato nel test DeleteResult.

    • L'endpoint DELETE /lineItems/{line_item_sourced_id} non è obbligatorio. È facoltativo e viene utilizzato per la pulizia dei dati.

  2. Tieni presente quanto segue riguardo alle sezioni Categorie di voto e Periodi di valutazione:

    • È richiesto un solo endpoint GET /categories. Commenta quello che non utilizzi se esegui tutti i test di conformità contemporaneamente:
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • Il supporto dei periodi di valutazione viene testato recuperando il term_sourced_id nel test GetAllClasses w/ filter. Questo term_sourced_id viene utilizzato per recuperare i periodi di valutazione nel termine chiamando l'endpoint GET terms/{term_sourced_id}/gradingPeriods?limit=10000 nel test GetGradingPeriodsForTerm.

Condividi i risultati del 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.1 di Google. Scarica o acquisisci uno screenshot del report generato. Invia il report via email e un link alla certificazione OneRoster 1.1 del tuo prodotto all'indirizzo classroom-sis-external@google.com.

Assistenza

Invia un'email a classroom-sis-external@google.com per qualsiasi domanda o dubbio.