Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la documentación sobre complementos para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

Requisitos de los complementos

Versión 1.0, 30 de abril de 2024.

Los criterios de 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Á”, “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 de usuario final (si corresponde)
	1.1	Se DEBE mostrar un mensaje fácil de usar al usuario cuando no tiene una licencia. El mensaje DEBE indicar claramente el motivo por el cual el complemento no se puede utilizar 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 pueden ser necesarios para usar el complemento. Si el complemento tiene un nivel pago, la ficha de Marketplace DEBE proporcionar un vínculo a una página web que proporcione más información sobre los precios o cómo comunicarse con un vendedor.	REQUIRED
2.0	Acceso de usuario final
	2.1	Los usuarios profesores DEBEN acceder al complemento con el SSO de Google. Si se solicita a los usuarios alumnos que accedan al complemento, DEBEN hacerlo 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 una solicitud de acceso. Cuando la sugerencia de acceso no coincide con el usuario que accedió, el complemento DEBE pedirle al usuario un botón de acceso y pasar el login_hint a la biblioteca de autenticación para filtrar las cuentas no válidas.	REQUIRED
	2.7	Si el usuario de Classroom aún no accedió al complemento (como se determina en la sugerencia de acceso), el complemento DEBE presentar el botón "Acceder con Google" para que una 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 generales de aprobación de Google Workspace Marketplace.	REQUIRED
	3.2	Si una tarea se lanza en una pestaña o ventana nueva desde cualquiera de los recorridos de 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 complementario 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 las preferencias locales establecidas por el navegador cuando estén disponibles.	RECOMENDADOS
	3.5	Si un complemento define `maxPoints`, también DEBE configurar `pointsEarned` cuando un estudiante completa una entrega con credenciales de profesor almacenadas (recomendado) O cuando el profesor abre el envío en el iframe de Revisión del trabajo de los estudiantes.	REQUIRED
	3.9	Los complementos DEBEN cumplir con los lineamientos AA de las WCAG 2.1 sobre accesibilidad. Los desarrolladores de complementos informarán por cuenta propia que este requisito se cumple en el momento del envío y que este sigue cumpliendo con los cambios futuros que se realicen en él.	RECOMENDADOS
	3.10	Cualquier error que experimente un usuario DEBE ser legible por humanos.	REQUIRED
	3.11	Si se inicia `studentViewUri`, `teacherViewUri` o `studentWorkViewUri` desde una tarea o un curso copiados, 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 o un curso copiados, el complemento DEBE mostrar un nuevo archivo adjunto para que el estudiante lo complete. Además, NO DEBE mostrar en el iframe las respuestas de un estudiante de tareas o cursos anteriores.	RECOMENDADOS
4.0	Descubrimiento de adjuntos
	4.1	Si un archivo adjunto requiere la entrega de un estudiante, el archivo adjunto DEBE incluir un `studentWorkReviewUri` de modo que se trate como un tipo de actividad y no como un archivo adjunto de tipo de contenido.	REQUIRED
	4.2	El iframe de detección de archivos adjuntos DEBE proporcionar una interfaz de usuario que ofrezca al menos una de las siguientes opciones: Crear contenido nuevo para adjuntar Explora, selecciona y adjunta archivos de una biblioteca de contenido Instrucciones para adjuntar contenido de tu sitio web o de otros productos	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 la posibilidad de obtener una vista previa del contenido o la actividad antes de comprometerse a adjuntarlos a la tarea.	REQUIRED
	4.5	Si el profesor debe trabajar para crear contenido o 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 `studentViewUri`, el complemento NO DEBE quitar al usuario del iframe para completar una tarea. Si el complemento quita al usuario del iframe, DEBE haber un mensaje o alguna otra indicación para que los estudiantes vuelvan a Classroom.	RECOMENDADOS
	5.2	Si una actividad complementaria aparece fuera del iframe, DEBE haber una vista previa de la tarea en el iframe.	REQUIRED
	5.3	Si una actividad requiere que un alumno realice alguna acción para marcar el trabajo como completado, el botón NO DEBE estar etiquetado como “Entregar” para evitar confusiones con el botón Entrega de Classroom.	REQUIRED
6.0	Vista del profesor
	6.1	El profesor DEBE poder ver lo que verá el alumno cuando realice la tarea.	RECOMENDADOS
7.0	Revisión del trabajo de los alumnos
	7.1	Si se inicia `studentWorkReviewUri`, el complemento DEBE renderizar el trabajo de ese estudiante para que lo revise el profesor dentro del iframe. Es posible que el material complementario se vincule fuera del iframe.	REQUIRED
	7.2	El complemento NO DEBE habilitar la navegación entre estudiantes en la vista `studentWorkReviewUri`. La navegación entre los estudiantes DEBE realizarse únicamente en la IU de Classroom.	REQUIRED
8.0	Compatibilidad con dispositivos móviles para Classroom
	8.1	Cuando la app para dispositivos móviles de Classroom inicia un `teacherViewUri`, `studentViewUri` o `studentWorkReviewUri`, la URL DEBE abrir la app nativa para dispositivos móviles del socio o la app web móvil del socio y, en ambos casos, 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 se trata de un dispositivo no compatible y, idealmente, cuáles son los dispositivos compatibles.	REQUIRED
	8.2	El trabajo de los alumnos DEBE 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, DEBES actualizar los vínculos para que sean archivos adjuntos de complementos.	RECOMENDADOS
	9.2	Si usas una integración de CourseWork para crear tareas desde fuera de Classroom, DEBES crear archivos adjuntos de complemento 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	Combinar las versiones 1.1 y 1.2 en un solo requisito
2.1	2.1 y 2.5 combinados en un único requisito.
2.2	Se combinaron 2.2, 2.3 y 2.4 en un solo requisito.
3.5	Se combinaron 3.5, 3.6 y 3.7 en un solo requisito.
3.10	Se agregó un requisito para que el complemento nunca entre en un estado ininteligible o irrecuperable.
3.11 y 3.12	Se combinaron 5.5, 5.6, 6.3, 6.4, 7.5 y 7.6 en dos requisitos nuevos.
4.2	Se expandió la descripción de las experiencias aceptables de Descubrimiento de adjuntos.
4.3	Cambio de número, anteriormente 4.2. También se cambió de REQUIRED a RECOMMENDED.
4.4	Cambio de número, anteriormente 4.3.
4.5	Se volvió a numerar, anteriormente 4.4.
5.2	Se cambió a número; antes era 5.3.
5.3	Se cambió a número, anteriormente 5.2.
9.1	Se agregó una recomendación para actualizar los vínculos pegados en los archivos adjuntos.
9.2	Se agregó una recomendación 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 y 7.4	Se quitó el elemento.
Versión 0.3	Actualizado el 22 de noviembre de 2022
2.3	Corrección de la guía de sugerencias de acceso.
2.4	Se incorporó una situación en la que es necesario implementar `hd`.
3.2	Se reformuló "Proporcionar ruta".
5.5, 5.6, 6.3, 6.4, 7.5 y 7.6	Se agregó un texto del curso obligatorio y 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 sea más claro de 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	WCAG cambió REQUIRED a RECOMMENDED.
5.1	Se cambió REQUIRED a RECOMMENDED.
5.3	Se agregó "Si los complementos aparecen fuera del iframe, SE DEBE tener una vista previa de la tarea en el iframe".
5.4	Se agregó "Si el complemento aparece fuera del iframe, debería 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, idealmente, qué dispositivos son compatibles".
8.2	El trabajo móvil de los estudiantes cambió de REQUIRED a RECOMMENDED.
Versión 0.1	Actualizado el 22 de septiembre de 2021
	Versión inicial