Cómo interactuar con archivos adjuntos

En esta página, se analizan los detalles de implementación para crear un adjunto y cómo trabajar con las entregas de los estudiantes. Ten en cuenta que es posible que debas proporcionar parámetros relacionados con los archivos adjuntos cuando realicen estas solicitudes.

Crea un adjunto

Para crear un adjunto, envía una solicitud CREATE a la dirección extremo courses.*.addOnAttachments.create. Tu solicitud debe incluir una instancia de AddOnAttachment en el cuerpo de la solicitud.

Los siguientes campos son obligatorios cuando se crea un adjunto:

• title: Es el nombre de cadena del adjunto.
• teacherViewUri: Es el URI de la Vista para profesores del adjunto.
• studentViewUri: Es el URI de la vista de estudiante del archivo adjunto.
• studentWorkReviewUri: Es el URI para el que el profesor verá el trabajo del estudiante. el archivo adjunto. Este campo solo es obligatorio para los archivos adjuntos de tipo de actividad.

Puedes incluir algunos de los siguientes campos opcionales:

• dueDate y dueTime si se especifica la fecha de vencimiento del adjunto.
• maxPoints: La calificación máxima para el archivo adjunto. Debe ser un valor distinto de cero si quieres admitir la devolución de calificaciones. Se aplica a los archivos adjuntos de tipo de actividad solamente.

Consulta la referencia del recurso AddOnAttachment para obtener más detalles sobre estos campos.

Detalles de entrega del estudiante

Un flujo de trabajo de envío típico sigue estos pasos:

1. Un estudiante inicia el studentViewUri para completar una actividad.
2. El complemento recupera un submissionId del método getAddOnContext. usando credenciales de estudiantes.
3. El complemento almacena los elementos submissionId y attachmentId desarrollador como el identificador único del trabajo del estudiante. En el caso de que si un profesor copia una tarea en Classroom, puedes usar de estos dos parámetros para mostrar un nuevo adjunto en el copiaste la tarea. Consulta nuestra página sobre el contenido copiado para obtener más detalles.
4. Un profesor interesado en revisar el trabajo de los alumnos inicia el studentWorkReviewUri La solicitud incluye los siguientes parámetros de consulta: courseId, itemId, itemType, attachmentId y submissionId.
5. El desarrollador del complemento usa estos cuatro ID para recuperar el trabajo del alumno. Usa el extremo courses.courseWork.addOnAttachments.studentSubmissions recuperar o modificar información sobre las entregas de un estudiante.

Detecta el estado del envío

Envía una solicitud GET al courses.courseWork.addOnAttachments.studentSubmissions para obtener detalles sobre un submissionId específico. Recibes un Un objeto AddOnAttachmentStudentSubmission, que contiene la calificación de la entrega (pointsEarned) y el estado actual (postSubmissionState). El estado del envío puede ser uno de los siguientes valores:

• NEW, si el estudiante nunca accedió a la entrega
• CREATED, si el estudiante creó una entrega, pero aún no la envió.
• TURNED_IN, si el estudiante envió su trabajo al profesor
• RETURNED, si el profesor le devolvió la entrega al estudiante
• RECLAIMED_BY_STUDENT, si el estudiante “anuló la entrega” su trabajo.

Usa este extremo para detectar el estado del trabajo del estudiante en tu complemento. Tú puede ajustar las vistas o las opciones proporcionadas al estudiante según el estado que se muestra. Esto podría incluir funciones como las siguientes:

• Se muestra el estado de entrega de las tareas del complemento. Esto puede Ayudan a los estudiantes a evitar posibles confusiones y garantizan que no se cometan erróneamente no entregar una tarea.
• Se restringen los privilegios de edición de envíos. Si la asignación tiene estado CREATED o RECLAIMED_BY_STUDENT, es posible que el estudiante pueda editar su presentación. Si la asignación tiene el estado TURNED_IN o RETURNED, es posible que el estudiante no tenga permitido editar su entrega.

Calificaciones y varios archivos adjuntos

Solo se puede usar un archivo adjunto de complemento para definir la calificación de una sola asignación. Si un profesor crea más de un archivo adjunto con el tipo de actividad que proporciona un valor maxPoints, solo el primer archivo adjunto puede establecer la calificación de la tarea. Deja el valor maxPoints sin establecer o configúralo en cero. inhabilitar la devolución de calificaciones de un archivo adjunto.

Cómo configurar la calificación de una entrega

Puedes modificar la entrega de un estudiante enviando una solicitud PATCH a la extremo courses.courseWork.addOnAttachments.studentSubmissions. La solicitud body debe incluir una instancia de AddOnAttachmentStudentSubmission con el y los valores modificados. Configura el campo pointsEarned para modificar la calificación de una entrega. El valor pasado en pointsEarned se convierte en una calificación en borrador visible para el en la IU de Classroom. Los profesores pueden modificar la calificación preliminar antes de devolverles la tarea a los estudiantes. Consulta Descripción general de las calificaciones en la IU de Classroom para obtener detalles sobre cómo están las calificaciones presentarse a los profesores.

Ten en cuenta que puedes configurar la calificación con pointsEarned solo si se cumplen las siguientes condiciones: verdadero:

• El adjunto debe tener un valor de maxPoints positivo.
• El complemento tiene que haber sido el creador original del archivo adjunto.

También ten en cuenta que puedes modificar el maxPoints de un AddOnAttachment ya creado. valor mediante la emisión de una solicitud PATCH al extremo addOnAttachments.

Cuándo establecer una calificación

Puedes elegir cuándo se devuelve una calificación a Google Classroom. El distinción fundamental es si eliges almacenar las credenciales de los profesores, como solo el profesor puede modificar una calificación.

Existen dos momentos adicionales en los que podrías aprobar una calificación para Google Classroom: Cuándo el estudiante completa su trabajo o cuando el profesor Abre el trabajo del estudiante en el iframe de Revisión del trabajo del alumno.

Si quieres establecer calificaciones cuando el estudiante complete el trabajo, debes almacenar una credenciales sin conexión de los profesores y, luego, recuperarlas y usarlas para modificar la calificación cuando el estudiante completa el trabajo. Este método proporciona cierto potencial beneficios:

• Proporciona actualizaciones de calificaciones sin interrupciones. No es necesario que los profesores realicen ninguna tarea especial para hacer que las calificaciones se propaguen en la IU de Classroom.
• Proporcionan información en tiempo real sobre el progreso de una clase en una tarea. Al establecer calificaciones a medida que los estudiantes completan los archivos adjuntos, los profesores pueden hacerse una idea de la cantidad de estudiantes comprensión sin abrir cada presentación.

Ten en cuenta que este enfoque también permite un enfoque asíncrono para calificar sincronizar. Puedes sondear periódicamente el AddOnAttachmentStudentSubmission para detectar cuándo un estudiante envía su trabajo. Cuando se haya enviada, configura la calificación de la entrega con las credenciales almacenadas.

Si no quieres cargar las credenciales de un profesor durante la sesión de un alumno, puedes usar las credenciales del profesor activo cuando se carguen en el iframe de Revisión del trabajo de los alumnos. Sin embargo, es posible que esto no proporcione una experiencia del usuario muy fluida como calificaciones en la IU de Classroom. no se actualizan en tiempo real y los profesores tendrían que abrir cada el iframe de revisión del trabajo del estudiante de la entrega.

Detecta cambios en las calificaciones de las tareas

los profesores pueden editar la configuración de las calificaciones en Classroom después de crear una tarea. Esas ediciones pueden incluyen:

• Cambiarás la puntuación asignada.
• Cambiar el valor maxPoints de una tarea
• Cambiar si se debe calificar la tarea o no.

Para ver la configuración de calificación actual de una tarea, te recomendamos que envíes Una solicitud GET al extremo courses.courseWork La respuesta incluye el valor actual de maxPoints. Una tarea sin calificar tiene un valor nulo o cero Valor maxPoints.

Si ya aprobaste una calificación en Classroom, usa la courses.courseWork.addOnAttachments.studentSubmissions extremo para recuperar o alterar la calificación de un archivo adjunto de complemento. El valor de la calificación se establece con el pointsEarned. Considera verificar y, si es necesario, actualizar este valor Si tu producto permite que los profesores editen la puntuación de un estudiante para un determinado actividad.