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) que cumplen con OneRoster. Google se asocia con plataformas de SIE que cumplen con los requisitos de OneRoster especificados por Google.

La asociación con Classroom brinda a los administradores la capacidad de 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 SIE

Si te interesa asociarte con Classroom, completa el formulario de interés.

El equipo de Classroom creó un conjunto de pruebas de conformidad que los socios interesados en el SIE pueden usar para familiarizarse con los requisitos de Google. Tienes la opción de ejecutar las pruebas de conformidad antes de comunicarte con el equipo de Classroom para determinar qué tan cerca está tu producto de cumplir con los requisitos de Google.

Obtén un dominio de demostración para desarrolladores

Es posible que desees acceder a una instancia activa de Google Classroom para compilar y validar una integración. Los usuarios de prueba aptos necesitan la edición Plus de Google Workspace for Education. Si no tienes acceso de administrador a un dominio de Google Workspace for Education con estas licencias, completa los pasos para obtener un dominio de prueba para desarrolladores y solicitar una actualización del dominio de demostración. Tu dominio se aprovisionará con 10 licencias de Google Workspace for Education Plus.

Accede a las pruebas y ejecútalas

Para ejecutar las pruebas, necesitas lo siguiente:

  • URL del token para recuperar las 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 del profesor

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

Requisitos y comportamiento esperado del SIE

Las pruebas definidas por Google existen para proporcionar a los socios interesados en el SIE 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 utilizan las integraciones del SIE en Classroom. Lee las siguientes indicaciones sobre las pruebas. En GitHub, cada prueba tiene un título al que se hace referencia en los punteros. Ten en cuenta que los indicadores pueden ayudar a aclarar preguntas, pero no son una lista exhaustiva de las pruebas. Asegúrate de haber ejecutado todas las pruebas proporcionadas en GitHub.

Prueba Punteros
Teachers: 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.
Teachers: GetAllTeachers con filtro de correo electrónico Se llama al extremo GET /teachers con un parámetro de búsqueda 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 Credentials 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 debe devolverse 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 período 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 Se debe poder establecer el score en un valor mayor que el resultValueMax para representar créditos adicionales.
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 subsiguiente 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 el informe generado o toma una captura de pantalla para compartirlo con el equipo de Google Classroom.

Obtenga asistencia

Si tienes preguntas, envía un correo electrónico a classroom-sis-external@google.com.