Para integrar tu SIA con Classroom, ejecuta el conjunto de pruebas de conformidad proporcionado y valida 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, 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 del profesor
El paquete de pruebas tiene tres secciones:
- Sincronización de calificaciones básicas
- Categorías de calificación
- Períodos de calificación
Puedes ejecutar las pruebas con Google Colab o un notebook de Jupyter. Colab y el notebook de Jupyter te permiten ejecutar todas las pruebas a la vez. Esto te ayudará a generar los resultados de las pruebas para compartirlos con el equipo de Google Classroom.
Requisitos del SIE y comportamiento esperado
Las pruebas definidas por Google existen para mantener la coherencia y minimizar los errores que los usuarios pueden experimentar cuando usan integraciones de SIS con Classroom. Lee los siguientes indicadores sobre las pruebas. En GitHub, cada prueba tiene un título al que se hace referencia en los punteros. Ten en cuenta que los consejos pueden ayudar a aclarar preguntas, pero no se trata de una lista completa de las pruebas. Asegúrate de haber ejecutado todas las pruebas proporcionadas en GitHub.
Sincronización de calificaciones básica
| 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. |
| LineItem: Create | No se requieren categorías ni períodos de calificación cuando se llama a PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | La llamada a la API no debe mostrar un error si se incluye un título largo de asignación. La prueba incluye un título de tarea de más de 100 caracteres de longitud. |
| 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 datos. El extremo GET /classes/{class_sourced_id}/lineItems posterior también es opcional y prueba que se borró la línea de pedido. |
Categorías de calificación
| Prueba | Punteros |
|---|---|
| GetAllCategories o GetCategoriesForClass | Solo se requiere un extremo GET /categories, ya sea GetAllCategories o GetCategoriesForClass. Marca como comentario el que no uses si ejecutas todas las pruebas a la vez. |
| DeleteLineItem (opcional / limpieza) | La prueba DeleteLineItem es opcional y se puede usar para la limpieza de datos. |
Períodos de calificación
| Prueba | Punteros |
|---|---|
| GetGradingPeriodsForTerm | Para probar la compatibilidad con los períodos de calificación, se recupera el term_sourced_id en la prueba GetAllClasses con filtro. 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 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 una. 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 el informe y un vínculo a la certificación de OneRoster 1.1 de tu producto por correo electrónico a classroom-sis-external@google.com.
Obtenga asistencia
Si tienes preguntas o inquietudes, escribe un correo electrónico a classroom-sis-external@google.com.