Google Classroom admite la sincronización de la libreta 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 les 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 de SIE interesados 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 bien cumple tu producto con los requisitos de Google.
Obtén un dominio de demostración para desarrolladores
Es posible que quieras 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/v1p2 - ID de cliente
- Secreto del cliente
- Una dirección de correo electrónico del 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 del SIE
Las pruebas definidas por Google existen para proporcionar a los socios de 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 utilizan las integraciones de SIE en Classroom. Lee los siguientes punteros 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 preguntas, pero no son una lista completa de las pruebas. Asegúrate de haber ejecutado todas las pruebas que se proporcionan 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 with email filter | Se llama al extremo GET /teachers con un parámetro de consulta filter que se usa para filtrar según una dirección de correo electrónico del profesor. Se usará la dirección de correo electrónico del profesor que proporcionaste en la sección Credenciales de las pruebas. |
| Classes: 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. |
| Students: GetStudentsForClass | Se llama al extremo GET /classes/{class_sourced_id}/students. El correo electrónico del estudiante debe mostrarse en la respuesta. |
| GetGradingPeriodsForTerm | La compatibilidad con los períodos de calificación se prueba con el term_sourced_id. Este term_sourced_id se usa para recuperar los períodos de calificación en el 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 una longitud de título de tarea larga. La prueba incluye una longitud de título de tarea de más de 100 caracteres. |
| Result: Edit | Debería ser posible establecer el score en un valor mayor que el resultValueMax para representar el crédito adicional. |
| Result: Delete | Se requiere el extremo DELETE /results/{result_sourced_id}. |
| LineItem (Optional / Cleanup): Delete and Get | No se requiere el extremo DELETE /lineItems/{line_item_sourced_id}. 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 haya borrado el elemento de línea. |
Comparte los resultados de las pruebas con el equipo de Google Classroom
Después de ejecutar las pruebas, se genera un informe completo con los resultados de cada prueba. 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
Envía un correo electrónico a classroom-sis-external@google.com si tienes alguna pregunta.