Google Classroom admite la importación de listas y la sincronización del libro de calificaciones 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.
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 incorporación de socios de SIA
A continuación, se incluye una breve descripción general del recorrido de incorporación de socios de SIS:
Expresa tu interés: Si te interesa asociarte con Classroom, completa el formulario de interés.
Explora y ejecuta las pruebas de conformidad: Para saber si tu SIE está listo para integrarse con Classroom, puedes revisar las pruebas de conformidad para familiarizarte con los requisitos de Google. Tienes la opción de ejecutar las pruebas de conformidad antes de expresar tu interés al equipo de Google Classroom para determinar qué tan bien cumple tu producto con los requisitos de Google.
Comunícate con el equipo de Google Classroom: El equipo de Classroom se comunicará contigo después de que envíes el formulario de interés si existe la oportunidad de asociarse.
Comparte los resultados de la prueba y compila la integración de extremo a extremo: Una vez que el equipo de Classroom se comunique contigo, comparte los resultados de la prueba de conformidad. Tu equipo trabajará con Google para validar y completar la integración.
Pruebas de conformidad
Las pruebas de conformidad definidas por Google existen para proporcionar a los socios de SIE una forma de determinar si su producto cumple con los requisitos de consumo de OneRoster de Google y minimizar los errores que los usuarios podrían experimentar cuando usan las integraciones de SIE en Classroom. Las pruebas se publican en GitHub.
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/v1p2 - 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 ayuda a generar los resultados de las pruebas para compartirlos con el equipo de Google Classroom.
Requisitos y comportamiento esperado
Lee las siguientes sugerencias sobre las pruebas. En GitHub, cada prueba tiene un título al que se hace referencia en la tabla. Estos indicadores pueden ayudar a aclarar preguntas, pero no es una lista exhaustiva de las pruebas. Asegúrate de haber ejecutado todas las pruebas proporcionadas en GitHub para garantizar la conformidad.
| 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 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 una longitud de título de tarea de más de 100 caracteres. |
| Resultado: Editar | Debería ser posible establecer el valor de score en un valor mayor que el de resultValueMax para representar el 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 la limpieza de datos. El extremo GET /classes/{class_sourced_id}/lineItems posterior también es opcional y prueba que se haya borrado 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. Los resultados 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 tus contactos del equipo de Google Classroom.
Obtén un dominio de demostración para desarrolladores
Una vez que el equipo de Google Classroom revise los resultados de la prueba de conformidad, un dominio de demostración para desarrolladores te permitirá validar tu integración de extremo a extremo. Ten en cuenta que aprobar las pruebas de conformidad no garantiza la aprobación de la asociación o la integración.
Un dominio de demostración para desarrolladores es un entorno de prueba de Google Classroom en vivo que te ayuda a validar que tu integración funcione como esperas. Completa los pasos para obtener un dominio de demostración para desarrolladores y solicitar una actualización del dominio de demostración. La actualización aprovisiona tu dominio con 10 licencias de Google Workspace for Education Plus. Estas licencias se deben asignar a los usuarios de prueba de tu dominio de desarrollador para que puedan probar las funciones de integración del SIE en Classroom.
Preguntas frecuentes
1. ¿Qué modelo de datos espera Classroom del SIE?
Classroom cumple con la especificación de OneRoster 1.2. Si tu SIE usa una estructura de datos diferente, es posible que encuentres un comportamiento inesperado. Por ejemplo, si tu sistema admite una relación anidada entre los períodos de calificación y las categorías de calificación, esto queda fuera de la especificación de OneRoster 1.2, y debes probar tu integración de forma exhaustiva para garantizar la compatibilidad adecuada.
2. ¿Qué calificaciones y estados de tareas se exportan al SIA?
Solo se exportan al SIA las calificaciones devueltas o las entregas marcadas como "sin entregar" o "excluidas". No se exportan las calificaciones preliminares.
3. ¿Qué sucede con el elemento de una línea en el SIE si se borra una tarea en Classroom?
Si borras una tarea en Classroom, no se borrará la línea de pedido correspondiente en el SIA. Esto evita la pérdida accidental de datos y las eliminaciones en cascada no deseadas.