Versión 1.0, 30 de abril de 2024.
Los criterios que se indican en esta página se aplican a todos los complementos de Classroom. Tu complemento debe cumplir con todos los elementos obligatorios aplicables para que se apruebe su publicación en Google Workspace Marketplace y un complemento que diga “Funciona con Classroom”.
Las palabras clave “DEBE”, “NO DEBE”, “OBLIGATORIO”, “DEBERÍA”, “NO DEBERÍA”, “DEBERÍA”, “NO DEBERÍA”, “RECOMENDADO”, “PUEDE” y “OPCIONAL” de este documento se deben interpretar como se describe en RFC 2119.
Requisitos
| ID | Tipo | ||
|---|---|---|---|
| 1.0 | Licencia para el usuario final (si corresponde) | ||
| 1.1 | Se DEBE mostrar un mensaje fácil de usar al usuario cuando este no tiene una licencia. El mensaje DEBE indicar claramente el motivo por el que no se puede usar el complemento y sugerir un curso de acción para que el usuario solucione la situación. | REQUIRED | |
| 1.3 | La ficha de Google Workspace Marketplace del complemento DEBE especificar detalles sobre los requisitos de licencias que podrían requerirse para usar el complemento. Si el complemento tiene un nivel de pago, la ficha de Marketplace DEBE proporcionar un vínculo a una página web que brinde más información sobre los precios o cómo comunicarse con un vendedor. | REQUIRED | |
| 2.0 | Acceso de los usuarios finales | ||
| 2.1 | Los usuarios de profesores DEBEN acceder al complemento con el SSO de Google. Si se les pide a los usuarios de estudiantes que accedan al complemento, DEBEN acceder con el SSO de Google. |
REQUIRED | |
| 2.2 | El complemento DEBE usar el SSO de Google para que un usuario acceda automáticamente en visitas posteriores sin mostrar un mensaje de acceso. Cuando la sugerencia de acceso no coincide con el usuario que accedió, el complemento DEBE indicarle al usuario un botón de acceso y pasar el login_hint a la biblioteca de autenticación para que filtre las cuentas no válidas. |
REQUIRED | |
| 2.7 | Cuando el usuario de Classroom aún no accedió al complemento (según lo determinado en la sugerencia de acceso), este DEBE incluir el botón "Acceder con Google" para que la acción explícita del usuario active el proceso de acceso. Nota: Esto es necesario para cumplir con los lineamientos de desarrollo de la marca de Google y también ayuda a evitar los bloqueadores de ventanas emergentes. |
REQUIRED | |
| 2.8 | El complemento DEBE mostrar quién es el usuario que accedió. | RECOMENDADOS | |
| 3.0 | General | ||
| 3.1 | El complemento DEBE cumplir con los lineamientos de aprobación generales de Google Workspace Marketplace. | REQUIRED | |
| 3.2 | Si se inicia una tarea en una pestaña o ventana nueva desde cualquiera de los recorridos del iframe, DEBE proporcionar un mensaje fácil de usar para volver a Classroom. | REQUIRED | |
| 3.3 | El usuario solo DEBE completar el recorrido con un flujo de trabajo de complementos y no cambiar a un flujo de trabajo del curso ni usar el botón Compartir en Classroom. | REQUIRED | |
| 3.4 | Opción de localización: El idioma DEBE basarse en la preferencia local establecida por el navegador cuando está disponible. | RECOMENDADOS | |
| 3.5 | Si un complemento define maxPoints, también DEBE establecer pointsEarned cuando un estudiante completa una entrega con credenciales de profesor almacenadas (opción recomendada) O cuando el profesor abre el envío en el iframe de revisión del trabajo del estudiante. |
REQUIRED | |
| 3.9 | Los complementos DEBEN cumplir con los lineamientos de AA de nivel WCAG 2.1 sobre accesibilidad. Los desarrolladores de complementos informarán por su cuenta que se cumple este requisito en el momento del envío y que el complemento continúa cumpliendo con los cambios futuros que se realicen en él. | RECOMENDADOS | |
| 3.10 | Los errores que experimente un usuario DEBEN ser legibles. | REQUIRED | |
| 3.11 | Si se inicia studentViewUri, teacherViewUri o studentWorkViewUri desde una tarea o curso copiado, el complemento NO DEBE mostrar una página de error en el iframe. |
REQUIRED | |
| 3.12 | Si se inicia studentViewUri, teacherViewUri o studentWorkViewUri desde una tarea copiada o un curso copiado, el complemento DEBE mostrar un nuevo archivo adjunto para que el estudiante lo complete y NO DEBE mostrar las respuestas de un estudiante de tareas o cursos anteriores en el iframe. |
RECOMENDADOS | |
| 4.0 | Descubrimiento de archivos adjuntos | ||
| 4.1 | Si un archivo adjunto requiere la entrega de un estudiante, este DEBE incluir un studentWorkReviewUri para que se lo trate como un tipo de actividad y no como un archivo adjunto de tipo de contenido. |
REQUIRED | |
| 4.2 | El iframe de descubrimiento de archivos adjuntos DEBE proporcionar una interfaz de usuario que ofrezca, al menos, uno de los siguientes elementos:
|
REQUIRED | |
| 4.3 | El profesor DEBE poder encontrar todo el contenido o las actividades disponibles y acceder a él. | RECOMENDADOS | |
| 4.4 | El profesor DEBE tener una vista previa del contenido o la actividad antes de comprometerse a adjuntarlo a la tarea. | REQUIRED | |
| 4.5 | Si el profesor debe realizar una tarea para crear el contenido o la actividad antes de que se pueda adjuntar, ese trabajo DEBE completarse en el iframe. | RECOMENDADOS | |
| 5.0 | Vista del alumno | ||
| 5.1 | Cuando se inicia el studentViewUri, el complemento NO DEBE sacar al usuario del iframe para completar una tarea.Si el complemento sale del iframe, DEBE haber un mensaje o algún otro indicador para que los estudiantes regresen a Classroom. |
RECOMENDADOS | |
| 5.2 | Si una actividad de complemento aparece fuera del iframe, DEBE haber una vista previa de la tarea en el iframe. | REQUIRED | |
| 5.3 | Si una actividad requiere que un estudiante realice una acción para marcar el trabajo como finalizado, el botón NO DEBE tener la etiqueta “Entregar” para evitar confusiones con el botón Entregar en Classroom. | REQUIRED | |
| 6.0 | Vista de profesor | ||
| 6.1 | El profesor DEBE poder ver lo que el alumno verá cuando haga la tarea. | RECOMENDADOS | |
| 7.0 | Revisión del trabajo de los alumnos | ||
| 7.1 | Si se inicia el studentWorkReviewUri, el complemento DEBE renderizar el trabajo del estudiante para que lo revise dentro del iframe. Es posible que el material complementario incluya vínculos fuera del iframe. |
REQUIRED | |
| 7.2 | El complemento NO DEBE habilitar la navegación entre estudiantes en la vista de studentWorkReviewUri. La navegación entre estudiantes DEBE tener lugar únicamente en la IU de Classroom. |
REQUIRED | |
| 8.0 | Compatibilidad con dispositivos móviles de Classroom | ||
| 8.1 | Cuando la app para dispositivos móviles de Classroom inicia un objeto teacherViewUri, studentViewUri o studentWorkReviewUri, la URL DEBE abrir la app nativa para dispositivos móviles del socio o la app web para dispositivos móviles del socio y, en cualquier caso, establecer un vínculo directo a la vista correcta. Si el dispositivo no es compatible, se DEBE mostrar un mensaje al usuario para informarle que es un dispositivo no compatible y, de ser así, qué dispositivos son compatibles. |
REQUIRED | |
| 8.2 | El trabajo de los alumnos DEBE poder completarse en un dispositivo móvil. | RECOMENDADOS | |
| 9.0 | Funciones adicionales | ||
| 9.1 | Si los profesores pueden pegar vínculos a tu contenido como archivos adjuntos de vínculos, DEBES actualizar los vínculos a archivos adjuntos de complementos. | RECOMENDADOS | |
| 9.2 | Si usas una integración de CourseWork para crear tareas fuera de Classroom, DEBES crear archivos adjuntos de complementos de forma predeterminada para todos los vínculos compatibles con tu complemento. | RECOMENDADOS | |
Registro de cambios
| Versión 1.0 | Actualizado el 30 de abril de 2024 |
| 1.1 | Combinamos las secciones 1.1 y 1.2 en un solo requisito. |
| 2.1 | Combinamos las secciones 2.1 y 2.5 en un solo requisito. |
| 2.2 | Combinamos los puntos 2.2, 2.3 y 2.4 en un solo requisito. |
| 3.5 | Combinamos los 3.5, 3.6 y 3.7 en un solo requisito. |
| 3.10 | Se agregó el requisito de que el complemento nunca pase a un estado ininteligible o irrecuperable. |
| 3,11, 3,12 | Se combinaron 5.5, 5.6, 6.3, 6.4, 7.5 y 7.6 en dos requisitos nuevos. |
| 4.2 | Se amplió la descripción de las experiencias aceptables de descubrimiento de archivos adjuntos. |
| 4.3 | Se cambió el número, anteriormente 4.2. También se cambió de REQUIRED a RECOMMENDED. |
| 4.4 | Se cambió el número, anteriormente 4.3. |
| 4.5 | Renumerado, anteriormente 4.4. |
| 5.2 | Se cambió el número, anteriormente 5.3. |
| 5.3 | Se cambió el número, anteriormente 5.2. |
| 9.1 | Se agregó una recomendación para actualizar los vínculos pegados a los archivos adjuntos. |
| 9.2 | Se agregó un requisito para crear archivos adjuntos de complementos de forma predeterminada cuando se crean tareas de CourseWork de manera programática. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | Se quitó el elemento. |
| Versión 0.3 | Actualización: 22 de noviembre de 2022 |
| 2.3 | Se corrigió la guía de sugerencias de acceso. |
| 2.4 | Se incorporó un escenario en el que se requiere la implementación de hd. |
| 3.2 | Se reformuló la frase "proporcionar ruta". |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | Se agregó la copia del curso obligatoria y la orientación recomendada para studentViewUri, teacherViewUri y studentWorkReviewUri. |
| Versión 0.2 | Actualizado el 29 de octubre de 2021 |
| 1.3 | Se ajustó el texto para que tuviera una mayor claridad con respecto a la intención. |
| 3.1 | Se agregó: "El complemento DEBE cumplir con los lineamientos generales de aprobación de GWM que se encuentran en su sitio web". |
| 3.9 | Las WCAG cambiaron de REQUIRED a RECOMMENDED. |
| 5.1 | Se cambió REQUIRED a RECOMMENDED. |
| 5.3 | Se agregó "Si los complementos salen del iframe, DEBE tener una vista previa de la tarea en el iframe". |
| 5.4 | Se agregó: “Si el complemento aparece fuera del iframe, DEBE haber un mensaje para que los estudiantes vuelvan a Classroom”. |
| 8.1 | Se agregó: "Si el dispositivo no es compatible, se DEBE mostrar un mensaje al usuario para informarle que se trata de un dispositivo no compatible y, de ser así, qué dispositivos son compatibles". |
| 8.2 | El trabajo de los alumnos desde dispositivos móviles cambió de REQUIRED a RECOMMENDED. |
| Versión 0.1 | Actualizado el 22 de septiembre de 2021 |
| Versión inicial |