Valida que tu SIE cumpla con los requisitos de Google Classroom

Para integrar tu SIA con Classroom, ejecuta el conjunto proporcionado de pruebas de cumplimiento para validar que tu producto cumpla con los requisitos de asociación de Classroom.

Accede a las pruebas y ejecútalas

Puedes acceder a las pruebas de cumplimiento en GitHub. Para ejecutar las pruebas, necesitarás lo siguiente:

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

El paquete de pruebas tiene tres secciones:

• Sincronización de calificación básica
• Categorías de calificación
• Períodos de calificación

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

Requisitos del SIA y comportamiento esperado

Las pruebas definidas por Google existen para mantener la coherencia y minimizar los errores que pueden experimentar los usuarios cuando usan integraciones del SIA con Classroom. Lee los siguientes punteros sobre las pruebas. En GitHub, cada prueba está marcada con @title. Se hace referencia a estos títulos en los punteros.

Importante: A continuación, se incluyen algunos consejos para ayudarte a realizar la integración en Classroom. Usa los resultados de la prueba de conformidad para asegurarte de que se cumplieron los requisitos.

1. Ten en cuenta lo siguiente sobre la sección Sincronización de calificaciones básicas:

   • En la prueba GetAllTeachers, se llama al extremo GET /teachers con un parámetro de consulta limit=. En pruebas posteriores, se usa este parámetro para garantizar que tu producto pueda admitir un tamaño de página de 10,000.

   • En la prueba GetAllTeachers with email filter, se llama al extremo GET /teachers con un parámetro de consulta filter= que se usa para filtrar en función de la dirección de correo electrónico de un profesor. Cuando ejecutas las pruebas, debes especificar la dirección de correo electrónico de un profesor.

   • En la prueba 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.

   • En la prueba GetStudentsForClass, se llama al extremo GET /classes/{class_sourced_id}/students?limit=10000. El correo electrónico del estudiante se debe devolver en la respuesta.

   • En la prueba PutLineItem Create, no se requieren categorías de calificación o períodos de calificación cuando se llama a PUT /lineItems/{line_item_sourced_id}.

   • En la prueba PutLineItem Edit, la llamada a la API no debe mostrar un error si se incluye una longitud de título de asignación larga. La prueba incluye el título de una tarea de más de 100 caracteres.

   • En la prueba PutResult Edit, debería ser posible configurar score en un valor mayor que resultValueMax para representar crédito adicional.

   • El extremo DELETE /results/{result_sourced_id} es obligatorio y se prueba en la prueba DeleteResult.

   • El extremo DELETE /lineItems/{line_item_sourced_id} no es obligatorio. Es opcional y se usa para la limpieza de datos.

2. Ten en cuenta lo siguiente sobre las secciones Categorías de calificación y Períodos de calificación:

   • Solo se requiere un extremo GET /categories. Marca como comentario la que no usas si ejecutas todas las pruebas de conformidad a la vez:
     • /categories?limit=10000
     • /classes/{class_sourced_id}/categories?limit=10000
   • La compatibilidad con los períodos de calificación se prueba recuperando term_sourced_id en la prueba GetAllClasses w/ filter. Este term_sourced_id se usa para recuperar los períodos de calificación del término mediante una llamada al extremo GET terms/{term_sourced_id}/gradingPeriods?limit=10000 en la prueba GetGradingPeriodsForTerm.

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 prueba. Estas pruebas se usan para determinar si tu producto cumple con los requisitos de consumo de OneRoster 1.1 de Google. Descarga o toma una captura de pantalla del informe generado. Envía por correo electrónico el informe y un vínculo a la certificación OneRoster 1.1 de tu producto a [e-mail].

Cómo obtener asistencia

Si tienes preguntas o inquietudes, envía un correo electrónico a [e-mail].