Preguntas frecuentes

Visualiza, crea y modifica CourseWork en Classroom

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

Los nuevos extremos permiten que los desarrolladores vean y administren el trabajo en una clase. En particular, puedes hacer todo lo siguiente:

  • Ver las tareas y preguntas (denominados en forma conjunta "Trabajo deCurso") para un usuario
  • Crea, modifica y borra CourseWork
  • Adjuntar materiales (archivos de Drive, videos de YouTube, enlaces) al trabajo del curso
  • Cambiar el estado de la entrega de un estudiante (como entrega, devolución o recuperación)
  • Cómo configurar la calificación de la entrega de una tarea
  • Adjunta materiales (archivos de Drive, videos de YouTube, vínculos) a las entregas de los alumnos.

Estos son algunos ejemplos de casos de uso para CourseWork:

  • Los libros de calificaciones, los SIE o los sistemas de informes pueden sincronizar tareas y calificaciones de Classroom con sus aplicaciones, lo que elimina la transferencia manual de datos de datos.
  • Las aplicaciones de aprendizaje pueden crear tareas nuevas que aparecerán en las novedades de la clase. A medida que los estudiantes completan el trabajo, las aplicaciones pueden entregar el trabajo, establecer las calificaciones, adjuntar el trabajo de los estudiantes y almacenarlo en las carpetas de Drive correspondientes.
  • Los usuarios de profesores pueden crear tareas con archivos adjuntos de complementos desde tu sitio web o aplicación.
  • Los usuarios estudiantes pueden entregar las tareas que tengan archivos adjuntos de complementos.

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

Por lo general, una aplicación solo puede modificar el trabajo que crea. En otras palabras, cualquier solicitud a la API de mutación de asignación debe usar el mismo ID del proyecto de Google Cloud que se almacenó en el momento de creación de la asignación.

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

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

¿Qué tipos de elementos puede adjuntar mi solicitud a las tareas o entregas?

La API admite adjuntar 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 de forma externa con el nombre del producto del proyecto de Google Cloud en el que se creó el trabajo. Los usuarios pueden informar que trabajos creados externamente como no deseados, así como desconectar la aplicación que creó el trabajo, mediante la revocación de las credenciales que el usuario emitió a la aplicación.

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 Compartir?

Aún no. Para modificar una asignación, la solicitud debe usar el mismo proyecto de Google Cloud en el que se creó la asignación.

¿Puedo responder preguntas en la API?

Aún no. Puedes crear y modificar preguntas. Responder a las preguntas de manera programática está en nuestra hoja de ruta.

Complementos de Classroom

Configuración de proyectos

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

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

¿Puede un proyecto de Google Cloud tener dos fichas de GWM?

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

Sin embargo, puedes agrupar complementos. Esto permite que una sola lista de GWM represente varios complementos. La instalación desde esa ficha permitirá instalar todos los complementos del paquete a la vez. Los usuarios tendrían que dar su consentimiento para todos los permisos necesarios para los complementos agrupados cuando se autoricen.

Existen dos consideraciones adicionales con respecto a la creación de paquetes:

  1. Los complementos de Classroom solo están disponibles para los suscriptores de Teaching & Learning Upgrade o el SKU de Education Plus.

  2. La API de complementos se encuentra en acceso anticipado y está restringida a los desarrolladores participantes y los proyectos de Google Cloud. Es posible que los complementos en paquete no funcionen según lo previsto si dependen de proyectos de Google Cloud que no participan.

¿Se puede volver a usar un cliente de OAuth de otro proyecto de Google Cloud 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 complementario 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 encaja bien en un cuadrado pequeño. ¿Qué opciones de tamaño hay para los logotipos en la barra de título del iframe?

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

Dominios

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

Los administradores de instituciones educativas tienen la capacidad de controlar qué profesores pueden ver un complemento instalado.

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

Los administradores de dominio controlan quiénes pueden usar tu complemento. Pueden instalar un complemento para todo un dominio mediante la opción de instalación del administrador. Si el complemento se puede instalar de forma individual, ten en cuenta que la mayoría de los administradores tienen una lista de complementos permitidos; los profesores pueden instalar los complementos que se incluyen en esta lista. Un administrador también podría optar por instalar el 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 de las siguientes opciones es una manera confiable de saber si la página del socio se carga dentro de un iframe o una pestaña emergente?

Por el momento, no existe un método para diferenciar ambos.

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

El iframe de revisión del trabajo de los estudiantes solo se proporciona para archivos adjuntos de tipo de 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 puede ser true solo para un tipo de entrada que sea una actividad.

¿Puede haber cambios rotundos en la API durante el programa de acceso anticipado?

La API de complementos aún está en desarrollo. Por lo tanto, puede haber cambios rotundos en la API que provoquen que las solicitudes exitosas anteriores fallen o se comporten de manera diferente. Se te notifica sobre cualquier cambio rotundo con anticipación a través del foro de desarrolladores.

¿Puede un archivo adjunto del complemento acceder al elemento de flujo al que está adjunto?

Sí. Puedes get o patch cualquier Announcement, CourseWork o CourseWorkMaterial que contenga al menos uno de tus archivos adjuntos de complementos. Puedes reclaim, return o turnIn y CourseWork StudentSubmission.

¿Cuándo se lanzarán públicamente los complementos de Classroom?

Los complementos de Classroom están disponibles para todos los usuarios finales desde el verano de 2022. Se espera que la API de complementos esté disponible de manera general para desarrolladores en algún momento de 2024.

Inicio de sesión único

Sí, pueden seguir usando el Acceso con Google.

¿Todos los alumnos 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, sin importar si tienen acceso a Gmail. Las identidades se representan con una dirección de correo electrónico. La identidad y el acceso a cualquier servicio de Google en particular (incluido Gmail) son diferentes. Por lo tanto, incluso si Gmail está inhabilitado, los estudiantes pueden acceder con su dirección de correo electrónico.

¿El administrador de una institución educativa debe aprobar previamente la app para permitir el acceso de los estudiantes?

Los administradores de dominio deben incluir un complemento en la lista de entidades permitidas para poder instalarlo. De manera opcional, los administradores de dominio pueden instalar un complemento para todos los usuarios dentro del dominio o en una unidad organizativa.

Comentarios y preguntas generales

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

Puedes enviar y ver solicitudes de funciones, así como votar por ellas, en nuestra herramienta de seguimiento de errores pública.

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

Las actualizaciones de la API se publican en la página de notas de la versión, en nuestro foro para desarrolladores y en la Herramienta de seguimiento de errores pública.

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

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