Preguntas frecuentes

Visualizar, crear y modificar CourseWork en Classroom

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

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

  • Ver las tareas y las preguntas (denominadas en conjunto CourseWork) de un usuario
  • Crear, modificar y borrar CourseWork
  • Adjuntar materiales (archivos de Drive, videos de YouTube y vínculos) a CourseWork
  • Cambia el estado de la entrega de un estudiante (por ejemplo, entregar, devolver o recuperar).
  • Establece la calificación de la entrega de una tarea.
  • Adjuntar materiales (archivos de Drive, videos de YouTube, vínculos) a las entregas de los estudiantes

Estos son algunos casos de uso de CourseWork:

  • Los registros de calificaciones, los SIE o los sistemas de informes pueden sincronizar las tareas y las 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 el trabajo, las aplicaciones pueden entregarlo, establecer calificaciones, adjuntar el trabajo de los estudiantes y almacenarlo en las carpetas de Drive correspondientes.
  • 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 tienen archivos adjuntos de tu 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 del proyecto de Google Cloud que se usó para crear CourseWork.

Los complementos de Google Classroom tienen 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, recuperar o devolver una tarea que tenga uno o más archivos adjuntos de complementos.

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

¿Qué tipos de elementos puede adjuntar mi aplicación a las tareas o entregas?

La API admite la adjunción de archivos de Drive, videos de YouTube y vínculos. Aún no se admite adjuntar 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 externamente con el nombre del producto del proyecto de Google Cloud que creó el trabajo. Los usuarios pueden marcar el trabajo creado externamente como no deseado y desconectar la aplicación que lo creó revocando las credenciales que el usuario le haya otorgado.

Botón Compartir en Classroom y otras integraciones

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

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

¿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. Esto permite que una sola ficha de Google Workspace Marketplace represente varios complementos. Si instalas desde esa ficha, se instalarán todos los complementos del paquete a la vez. Los usuarios deberán dar su consentimiento para todos los alcances que necesiten los complementos incluidos cuando realicen la autorización.

¿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 generados por otro proyecto de Google Cloud. Debes crear un cliente de OAuth independiente para el proyecto del complemento.

Experiencia del usuario

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

La barra de título del iframe se diseñó para admitir solo un logotipo cuadrado de 32 x 32. Esta elección se hizo para que coincida con la forma del favicon que las empresas usan en sus sitios web, y nuestra recomendación es que uses 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. Los complementos de Classroom solo pueden usarlos los usuarios con la licencia de Teaching and Learning o Education Plus.

¿Cómo interactúan los administradores de dominio 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 de complementos. Los profesores que se encuentran en esta lista pueden instalar complementos por su cuenta. Un administrador también puede optar por instalar tu complemento de forma individual para realizar pruebas.

Los administradores también pueden estar interesados en las estadísticas de uso relacionadas con tu complemento. Si tu producto lo admite, considera proporcionar estadísticas de uso de complementos 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 del estudiante?

El iframe de Revisión del trabajo del estudiante solo se proporciona para los archivos adjuntos de tipo actividad. Llama al método courses.courseWork.getAddOnContext para revelar 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í, aún pueden usar 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 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 te recomendamos que uses los IDs de usuario como claves principales cuando almacenes información del usuario.

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

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

Comentarios y preguntas generales

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

Puedes enviar, ver y votar solicitudes de funciones en nuestro servicio de 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.