OneRoster para sistemas de información de estudiantes

Google Classroom admite la sincronización del libro de calificaciones y la importación de listas para varios sistemas de información de estudiantes (SIE) compatibles con OneRoster. Google se asocia con plataformas de SIE que cumplen con los requisitos de OneRoster que especifica Google.

Asociarse con Classroom les permite a los administradores conectar sus clases de Classroom con tu SIE.

Figura 1: Cuando los sistemas de información de estudiantes (SIE) se asocian con Classroom, los administradores pueden elegir el SIE en el menú desplegable.

Recorrido de desarrollo de socios de SIA

Si te interesa colaborar con Classroom, escribe a classroom-sis-external@google.com para obtener más información.

El equipo de Classroom creó un conjunto de pruebas de conformidad que los socios interesados del SIA pueden usar para familiarizarse con los requisitos de Google. Puedes ejecutar las pruebas de conformidad antes de comunicarte con el equipo de Classroom para determinar qué tan bien tu producto cumple con los requisitos de Google.

Accede a las pruebas y ejecútalas

Para ejecutar las pruebas, necesitas lo siguiente:

  • URL del token para recuperar credenciales de OAuth 2.0
  • URL de OneRoster que termina en /ims/oneroster/v1p1
  • ID de cliente
  • Secreto del cliente
  • Una dirección de correo electrónico de un profesor

Puedes ejecutar las pruebas con Google Colab o un notebook de Jupyter. Tanto Colab como el notebook de Jupyter te permiten ejecutar todas las pruebas a la vez. Esto te ayudará a generar los resultados de la prueba para compartirlos con el equipo de Google Classroom.

Requisitos y comportamiento esperado del SIS

Las pruebas definidas por Google existen para proporcionar a los socios del SIE interesados una forma de determinar si su producto cumple con los requisitos de consumo de OneRoster de Google y para minimizar los errores que los usuarios podrían experimentar cuando usan las integraciones de SIE en Classroom. Lee los siguientes puntos sobre las pruebas. En GitHub, cada prueba tiene un título al que se hace referencia en los punteros. Ten en cuenta que los punteros pueden ayudar a aclarar las preguntas, pero no es una lista completa de las pruebas. Asegúrate de haber ejecutado todas las pruebas proporcionadas en GitHub.

Prueba Punteros
Profesores: GetAllTeachers Se llama al extremo GET /teachers con un parámetro de consulta limit. En las pruebas posteriores, este parámetro se usa para garantizar que tu producto pueda admitir un tamaño de página de 10,000.
Profesores: GetAllTeachers con filtro de correo electrónico Se llama al extremo GET /teachers con un parámetro de consulta filter que se usa para filtrar según la dirección de correo electrónico de un profesor. Se usará la dirección de correo electrónico del profesor que proporcionaste en la sección Credenciales de las pruebas.
Clases: GetClassesForTeacher Se llama al extremo /teachers/{teacher_sourced_id}/classes con un parámetro de consulta filter que se usa para filtrar según las clases activas.
Estudiantes: GetStudentsForClass Se llama al extremo GET /classes/{class_sourced_id}/students. El correo electrónico del estudiante se debe mostrar en la respuesta.
GetGradingPeriodsForTerm La compatibilidad con los períodos de calificación se prueba con term_sourced_id. Este term_sourced_id se usa para recuperar los períodos de calificación del trimestre llamando al extremo GET terms/{term_sourced_id}/gradingPeriods.
LineItem: Create No se requieren períodos de calificación cuando se llama a PUT /lineItems/{line_item_sourced_id}.
LineItem: Edit La llamada a la API no debería mostrar un error si se incluye un título de tarea largo. La prueba incluye un título de tarea de más de 100 caracteres.
Resultado: Editar Debería ser posible establecer score en un valor mayor que resultValueMax para representar crédito adicional.
Resultado: Borrar El extremo DELETE /results/{result_sourced_id} es obligatorio.
LineItem (opcional / limpieza): Borrar y obtener El extremo DELETE /lineItems/{line_item_sourced_id} no es obligatorio. Es opcional y se usa para limpiar los datos. El extremo GET /classes/{class_sourced_id}/lineItems posterior también es opcional y prueba que se borró la línea de pedido.

Comparte los resultados de la prueba con el equipo de Google Classroom

Después de ejecutar las pruebas, se genera un informe completo con los resultados de cada una. Estas pruebas se usan para determinar si tu producto cumple con los requisitos de consumo de OneRoster 1.2 de Google. Descarga o toma una captura de pantalla del informe generado para compartirlo con el equipo de Google Classroom.

Obtenga asistencia

Si tienes preguntas o inquietudes, escribe un correo electrónico a classroom-sis-external@google.com.