Interagir avec les pièces jointes

Cette page présente les détails de mise en œuvre de la création d'un rattachement les devoirs rendus par les élèves. Notez que vous devrez peut-être fournir paramètres liés aux pièces jointes lorsque vous effectuez ces requêtes.

Créer un rattachement

Créez une pièce jointe en envoyant une requête CREATE au Point de terminaison courses.*.addOnAttachments.create. Votre demande doit inclure un Une instance de AddOnAttachment dans le corps de la requête

Les champs suivants sont obligatoires lorsque vous créez un rattachement:

• title: nom de la chaîne du rattachement.
• teacherViewUri: URI de la vue enseignant de la pièce jointe.
• studentViewUri: URI de la vue élève de la pièce jointe.
• studentWorkReviewUri: URI permettant à l'enseignant d'afficher le travail de l'élève. la pièce jointe. Ce champ n'est obligatoire que pour les pièces jointes de type activité.

Vous pouvez inclure certains des champs facultatifs suivants:

• dueDate et dueTime si vous spécifiez la date limite de remise de la pièce jointe.
• maxPoints: note maximale de la pièce jointe. La valeur doit être non nulle pour permettre le renvoi des notes. S'applique aux pièces jointes de type activité uniquement.

Pour en savoir plus sur ces champs, consultez la documentation de référence de la ressource AddOnAttachment.

Détails du devoir envoyé par l'élève

Voici le processus type d'envoi:

1. Un élève lance l'studentViewUri pour terminer une activité.
2. Le module complémentaire récupère un submissionId à partir de la méthode getAddOnContext. à l'aide des identifiants des élèves.
3. submissionId et attachmentId sont stockés par le module complémentaire développeur comme identifiant unique du travail de l'élève. Si lorsqu'un enseignant copie un devoir dans Classroom, vous pouvez utiliser clé composite de ces deux paramètres pour afficher une nouvelle pièce jointe dans le devoir copié. Pour en savoir plus, consultez la page sur le contenu copié.
4. Un enseignant qui souhaite corriger les devoirs de ses élèves lance le studentWorkReviewUri La requête inclut les paramètres de requête suivants: courseId, itemId, itemType, attachmentId et submissionId.
5. Le développeur du module complémentaire utilise ces quatre ID pour récupérer le travail des élèves. Utilisez le point de terminaison courses.courseWork.addOnAttachments.studentSubmissions pour récupérer ou modifier des informations concernant le travail d'un élève.

Détecter l'état d'envoi

Envoyez une requête GET à courses.courseWork.addOnAttachments.studentSubmissions pour obtenir des détails sur un submissionId spécifique. Vous recevez une Un objet AddOnAttachmentStudentSubmission contenant la note du devoir (pointsEarned) et l'état actuel (postSubmissionState). État de l'envoi peut prendre l'une des valeurs suivantes:

• NEW, si l'élève n'a jamais accédé au devoir.
• CREATED, si l'élève a créé son devoir, mais ne l'a pas encore envoyé.
• TURNED_IN, si l'élève a rendu son travail à l'enseignant
• RETURNED, si l'enseignant a rendu le devoir à l'élève
• RECLAIMED_BY_STUDENT, si l'élève a annulé la remise du devoir leur travail.

Utilisez ce point de terminaison pour détecter l'état du travail de l'élève dans votre module complémentaire. Toi peut ensuite adapter les vues ou options proposées à l'élève en fonction affiché. Cela peut inclure des fonctionnalités telles que:

• Afficher l'état de remise des devoirs dans votre module complémentaire. Cela peut aident les élèves à éviter toute confusion éventuelle et s'assurer qu'ils ne se trompent pas ne pas remettre son devoir.
• Restriction des droits de modification de l'envoi. Si l'état de l'attribution est indiqué CREATED ou RECLAIMED_BY_STUDENT, l'élève peut être autorisé à modifier sa soumission. Si l'état du devoir est TURNED_IN ou RETURNED, l'élève ne sera peut-être pas autorisé à modifier son travail.

Notes et pièces jointes multiples

Une seule pièce jointe de module complémentaire peut être utilisée pour attribuer une note à un seul élément. attribution. Si un enseignant crée plusieurs pièces jointes de type activité qui fournit une valeur maxPoints, seule la première pièce jointe de ce type peut définir note attribuée au devoir. Ne définissez pas la valeur maxPoints ou définissez-la sur zéro sur désactiver le renvoi des notes pour une pièce jointe.

Définir la note d'un devoir

Vous pouvez modifier le travail d'un élève en envoyant une requête PATCH au point de terminaison courses.courseWork.addOnAttachments.studentSubmissions. La demande doit inclure une instance de AddOnAttachmentStudentSubmission avec le paramètre les valeurs modifiées. Définissez le champ pointsEarned pour modifier la note d'un envoi. La valeur transmise dans pointsEarned devient une note brouillon visible par le dans l'UI de Classroom. Les enseignants peuvent modifier la note temporaire avant de rendre un devoir aux élèves. Consultez la section Présentation de la notation dans le module UI de Classroom pour en savoir plus sur la façon dont les notes sont attribuées présentées aux enseignants.

Notez que vous ne pouvez attribuer une note avec pointsEarned que si les éléments suivants sont true:

• La pièce jointe doit comporter une valeur maxPoints positive.
• Le module complémentaire doit avoir été le créateur initial de la pièce jointe.

Notez également que vous pouvez modifier le maxPoints d'une AddOnAttachment déjà créée en envoyant une requête PATCH au point de terminaison addOnAttachments.

Quand attribuer une note ?

Vous avez la possibilité de choisir le moment où une note est renvoyée à Google Classroom. La la distinction essentielle est de choisir de stocker les identifiants de l'enseignant, seul l'enseignant peut modifier une note.

Il existe deux moments complémentaires au cours desquels vous pouvez donner une note à Google Classroom: lorsque l'élève termine son travail ou lorsque l'enseignant ouvre le devoir de l'élève dans l'iFrame de révision des devoirs des élèves.

Si vous souhaitez donner une note lorsque l'élève termine son travail, vous devez stocker un les identifiants hors connexion de l'enseignant, puis les récupérer et les utiliser pour modifier la note. lorsque l'élève a terminé son travail. Cette méthode offre une certaine possibilité avantages:

• Actualisez facilement les notes. Les enseignants n'ont pas besoin de suivre pour que les notes s'affichent dans l'UI de Classroom.
• Fournissez des informations en temps réel sur la progression d'un cours dans le cadre d'un devoir. En définissant les notes à mesure que les élèves remplissent les pièces jointes, les enseignants se font une idée de leurs élèves comprendre sans ouvrir chaque soumission.

Notez que cette approche permet également une approche asynchrone pour l'évaluation synchroniser. Vous pouvez interroger régulièrement le AddOnAttachmentStudentSubmission pour détecter quand un élève a rendu son travail. Une fois soumis, définissez la note du devoir à l'aide des identifiants stockés.

Si vous ne souhaitez pas charger les identifiants de l'enseignant lors d'une session élève, vous pouvez utiliser les identifiants de l'enseignant actif lors du chargement des dans l'iFrame de révision des devoirs des élèves. Toutefois, il est possible que vous ne puissiez pas une expérience utilisateur particulièrement fluide grâce aux notes dans l'interface utilisateur de Classroom ; ne se mettent pas à jour en temps réel et que les enseignants doivent ouvrir dans l'iFrame de révision des devoirs des élèves.

Détecter les changements dans les notes des devoirs

les enseignants peuvent modifier les paramètres de note dans Classroom après la création d'un devoir. De telles modifications peuvent incluent:

• Modifier la valeur des points attribués.
• Modification de la valeur maxPoints d'un devoir.
• Modifier si le devoir doit être noté ou non

Pour afficher les paramètres de notation actuels d'un devoir, nous vous recommandons d'envoyer une requête GET au point de terminaison courses.courseWork. La réponse inclut la valeur actuelle de maxPoints. Un devoir non noté a une valeur nulle ou zéro Valeur maxPoints.

Si vous avez renvoyé une note à Classroom, utilisez le courses.courseWork.addOnAttachments.studentSubmissions point de terminaison à récupérer ou modifier la note d'une pièce jointe de module complémentaire. La valeur de la note est définie à l'aide de la pointsEarned. Nous vous conseillons de vérifier cette valeur et de la mettre à jour si nécessaire. si votre produit permet aux enseignants de modifier la note d'un élève pour un activité.