Preguntas frecuentes

Cómo ver, crear y modificar el trabajo en clase en Classroom

¿Qué puedo crear con los extremos de CourseWork en la API de Classroom?

Los extremos permiten a los desarrolladores ver y administrar el trabajo en una clase. Específicamente, puedes hacer lo siguiente:

  • Consulta las tareas y las preguntas (denominadas colectivamente CourseWork) de un usuario.
  • Crear, modificar y borrar CourseWork
  • Adjunta materiales (archivos de Drive, videos de YouTube, vínculos) a CourseWork.
  • Cambiar el estado del envío de un estudiante (como entrega, devolución o recuperación)
  • Establece la calificación de una tarea enviada.
  • Adjuntar materiales (archivos de Drive, videos de YouTube, vínculos) a las tareas de los estudiantes

Estos son algunos casos de uso de muestra de CourseWork:

  • Los registros de calificaciones, los SIE o los sistemas de informes pueden sincronizar las tareas y calificaciones de Classroom con sus aplicaciones, lo que elimina la transferencia manual de datos.
  • Las aplicaciones de aprendizaje pueden crear tareas nuevas que aparecen en las novedades de la clase. A medida que los estudiantes completan sus tareas, las apps pueden entregarlas, establecer calificaciones, adjuntarlas y almacenarlas en las carpetas de Drive adecuadas.
  • Los usuarios que son profesores pueden crear tareas con archivos adjuntos de complementos desde tu sitio web o aplicación.
  • Los usuarios estudiantes pueden entregar sus tareas que tengan archivos adjuntos del complemento.

¿Qué permisos necesita mi aplicación para crear o modificar tareas?

Por lo general, una aplicación solo puede modificar el trabajo que crea. En otras palabras, cualquier solicitud a la API para modificar CourseWork debe usar el mismo ID de proyecto de Google Cloud que se usó para crear el CourseWork.

Los complementos de Google Classroom son una excepción a esta regla. Un proyecto de Cloud puede acceder a cualquier anuncio, tarea o material que tenga uno o más de sus archivos adjuntos de complementos, o bien modificarlos. Un proyecto de Cloud también puede entregar, reclamar o devolver una tarea que tenga uno o más de sus archivos adjuntos de complementos.

Las solicitudes a la API también requieren los alcances de usuario correctos. Los profesores pueden ver tareas, crearlas, adjuntar vínculos a las tareas entregadas y establecer calificaciones. Los estudiantes pueden ver las tareas, adjuntar vínculos a sus registros de tareas, entregar y reclamar sus envíos. Los administradores del dominio pueden ver CourseWork, pero no tienen permisos de escritura.

¿Qué tipos de elementos puedo adjuntar a las tareas o los envíos?

La API admite adjuntar archivos de Drive, videos de YouTube y vínculos. Aún no se admiten los formularios de Google nativos.

¿Los usuarios finales saben que mi aplicación creó una tarea en Classroom?

Sí. La IU de Classroom identifica las tareas creadas de forma externa con el nombre del producto del proyecto de Google Cloud que creó el trabajo. Los usuarios pueden informar el trabajo creado de forma externa como no deseado y desconectar la aplicación que lo creó revocando las credenciales que el usuario le emitió.

Botón Compartir en Classroom y otras integraciones

Ya integré el botón Compartir en Classroom. ¿Puedo modificar una tarea creada con el botón de compartir?

Todavía no. Para modificar una tarea, la solicitud debe usar el mismo proyecto de Google Cloud que la creó.

¿Puedo responder preguntas en la API?

Todavía no. Puedes crear y modificar preguntas.

Complementos de Classroom

Configuración de proyectos

¿Puedo convertir un proyecto privado de Google Cloud que usé durante el desarrollo en un proyecto público que pueda usar en producción?

No, no puedes convertir un proyecto privado de Google Cloud en uno público. Necesitas dos proyectos separados, uno para el desarrollo y otro para la producción.

¿Un solo proyecto de Google Cloud puede tener dos fichas de Google Workspace Marketplace?

No. No puedes crear dos fichas de Google Workspace Marketplace para un solo proyecto de Google Cloud.

Sin embargo, es posible agrupar complementos. De esta manera, una sola ficha de Google Workspace Marketplace puede representar varios complementos. Si instalas desde una ficha de este tipo, se instalarán todos los complementos del paquete a la vez. Los usuarios deberán dar su consentimiento para todos los permisos que necesiten los complementos agrupados cuando los autoricen.

¿Se puede reutilizar un cliente de OAuth de un proyecto de Google Cloud diferente con un proyecto de Google Cloud para complementos de Classroom?

No, un cliente de OAuth de un proyecto de Google Cloud que no sea el proyecto de Google Cloud del complemento de Classroom no puede funcionar. La API de Classroom rechaza los tokens de acceso que genera otro proyecto de Google Cloud. Debes crear un cliente de OAuth independiente para el proyecto del complemento.

Experiencia del usuario

Nuestro logotipo no se ajusta bien en un cuadrado pequeño. ¿Qué opciones de tamaño hay para los logotipos en la barra del título del iframe de complementos de Classroom?

La barra del título del iframe se diseñó para admitir solo un logotipo cuadrado de 32 × 32. Esta elección se hizo para que coincida con la forma del ícono de página que las empresas usan en sus sitios web, y nuestra guía es usar el mismo logotipo en el espacio para mantener la coherencia de la marca.

Dominios

¿Todos los profesores y estudiantes del mismo dominio tienen acceso a un complemento instalado?

Los administradores de dominio pueden controlar qué profesores pueden ver un complemento instalado. Solo los usuarios con la licencia de Teaching and Learning o Education Plus pueden usar los complementos de Classroom.

¿Cómo interactúan los administradores de dominios con los complementos?

Los administradores de dominio controlan quién puede usar tu complemento. Pueden instalar un complemento para todo un dominio con la opción de instalación del administrador. Si tu complemento se puede instalar de forma individual, ten en cuenta que la mayoría de los administradores mantienen una lista de entidades permitidas para complementos. Los profesores que se encuentran en esta lista pueden instalar complementos por su cuenta. Un administrador también puede optar por instalar el complemento de forma individual para realizar pruebas.

A los administradores también les pueden interesar las estadísticas de uso de tu complemento. Si tu producto lo admite, considera proporcionar estadísticas de uso del complemento en una vista de administrador en tu propio sitio.

API

¿Cuál es una forma confiable de saber si el contenido de los complementos se carga dentro de un iframe o una pestaña nueva?

Actualmente, no hay un método para distinguir entre ambos.

¿Qué elementos de trabajo asignables obtienen un iframe de revisión del trabajo de los estudiantes?

El iframe de revisión de trabajos de los estudiantes solo se proporciona para los archivos adjuntos de tipo de actividad. Llama al método courses.courseWork.getAddOnContext para saber si el tipo de publicación admite el trabajo de los estudiantes. El campo supportsStudentWork solo puede ser true para un tipo de publicación que sea una actividad.

¿Puede un archivo adjunto de complemento acceder al elemento de transmisión al que está adjunto?

Sí. Puedes get o patch cualquier Announcement, CourseWork o CourseWorkMaterial que contenga al menos uno de los archivos adjuntos de tu complemento. Puedes reclaim, return o turnIn un CourseWork StudentSubmission.

Inicio de sesión único

Sí, pueden seguir usando Acceder con Google.

¿Todos los estudiantes tienen una dirección de correo electrónico con el formato correcto, incluso si no tienen acceso a Gmail?

Todos los usuarios de Google Workspace for Education tienen una identidad de Google, independientemente de si tienen acceso a Gmail. La identidad y el acceso a cualquier servicio de Google en particular (incluido Gmail) son distintos. Incluso si Gmail está inhabilitado, los usuarios estudiantes pueden acceder a Classroom con su dirección de correo electrónico. Las identidades se representan con un ID de usuario y una dirección de correo electrónico. Un usuario de Google Workspace for Education puede cambiar su dirección de correo electrónico, por lo que se recomienda que uses los IDs de usuario como claves primarias cuando almacenes información del usuario.

¿Un administrador de la institución educativa debe aprobar previamente la app para permitir que los estudiantes accedan?

Los administradores de dominios deben agregar un complemento a la lista de entidades permitidas para que se pueda instalar. De manera opcional, los administradores de dominios pueden instalar un complemento para todos los usuarios del dominio o una unidad organizativa.

Comentarios y preguntas generales

¿Cómo puedo enviar solicitudes de funciones o problemas?

Puedes enviar, ver y votar por solicitudes de funciones en nuestro seguimiento de problemas público.

¿Cómo puedo saber cuándo hay funciones nuevas disponibles en la API de Classroom?

Las actualizaciones de la API se publican en el boletín informativo para desarrolladores y en el seguimiento de problemas público.

Estoy usando la API de Classroom. ¿Cómo puedo hacer preguntas técnicas?

Publica tus preguntas en Stack Overflow con la etiqueta google-classroom.