- Ressource: StudentSubmission
- RubricGrade
- AssignmentSubmission (Envoi d'affectations)
- Pièce jointe
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- État
- GradeHistory
- GradeChangeType
- Méthodes
Ressource: StudentSubmission
Envoi des devoirs par les élèves.
StudentSubmission
élément est généré lorsqu'un élément CourseWork
est créé.
Il est possible que les devoirs des élèves qui n'ont jamais été consultés (par exemple, lorsque state
= NOUVEAU) ne comportent pas d'heure de création ni d'heure de mise à jour.
Représentation JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Champs | |
---|---|
courseId |
Identifiant du cours. Lecture seule. |
courseWorkId |
Identifiant du devoir auquel il correspond. Lecture seule. |
id |
Identifiant attribué par Classroom à l'envoi de l'élève. Il s'agit d'une méthode unique parmi les envois pour le devoir concerné. Lecture seule. |
userId |
Identifiant de l'élève propriétaire de cet envoi. Lecture seule. |
creationTime |
Date et heure de création de cet envoi. Cette règle peut être désactivée si l'élève n'a pas accédé à cet élément. Lecture seule. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
updateTime |
Heure de la dernière modification de cet envoi. Cette règle peut être désactivée si l'élève n'a pas accédé à cet élément. Lecture seule. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
state |
État de cet envoi. Lecture seule. |
late |
Indique si cet envoi est en retard. Lecture seule. |
draftGrade |
Note en attente (facultative). Si cette règle n'est pas configurée, aucune note n'a été définie. Cette valeur doit être un nombre positif. Les valeurs décimales (c'est-à-dire non entières) sont autorisées, mais elles sont arrondies à deux chiffres après la virgule. Seuls les enseignants du cours peuvent voir ce paramètre et le modifier. |
assignedGrade |
Note facultative. Si cette règle n'est pas configurée, aucune note n'a été définie. Cette valeur doit être un nombre positif. Les valeurs décimales (c'est-à-dire non entières) sont autorisées, mais elles sont arrondies à deux chiffres après la virgule. Seuls les enseignants du cours peuvent modifier ce paramètre. |
rubricId |
Uniquement en sortie. Identifiant de la grille d'évaluation actuellement associée à ce devoir et utilisée pour noter ce devoir. Cet ID est vide s'il n'y a pas de grille d'évaluation. Cet ID reflète la grille d'évaluation actuellement active. Il change si les enseignants suppriment et recréent la grille d'évaluation. Lecture seule. |
draftRubricGrades |
Notes en attente de la grille d'évaluation d'après ses critères. Cette carte est vide si aucune grille d'évaluation n'est associée à ce devoir ou si une grille d'évaluation est jointe, mais qu'aucune note n'a été définie pour aucun critère. Les entrées ne sont renseignées que pour les notes qui ont été définies. Clé: ID de critère de la grille d'évaluation. Lecture seule. Objet contenant une liste de paires |
assignedRubricGrades |
Notes attribuées à la grille d'évaluation en fonction des critères de la grille d'évaluation. Cette carte est vide si aucune grille d'évaluation n'est associée à ce devoir ou si une grille d'évaluation est jointe, mais qu'aucune note n'a été définie pour les critères. Les entrées ne sont renseignées que pour les notes qui ont été définies. Clé: ID de critère de la grille d'évaluation. Lecture seule. Objet contenant une liste de paires |
alternateLink |
Lien absolu vers le devoir dans l'interface utilisateur Web de Classroom. Lecture seule. |
courseWorkType |
Type de devoir auquel cet envoi est destiné. Lecture seule. |
associatedWithDeveloper |
Indique si l'envoi de cet élève est associé au projet Play Console à l'origine de la demande. Pour en savoir plus, consultez Lecture seule. |
submissionHistory[] |
Historique de l'envoi (y compris l'historique de l'état et des notes) Lecture seule. |
previewVersion |
Uniquement en sortie. Version preview de l'API. Vous devez définir ce paramètre pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview. |
Champ d'union content . Contenu soumis Le type spécifique dépend de la valeur de course_work_type . La content ne peut être qu'un des éléments suivants : |
|
assignmentSubmission |
Contenu soumis lorsque courseWorkType est défini sur ASSIGNMENT. Les élèves peuvent modifier ce contenu à l'aide de |
shortAnswerSubmission |
Contenu soumis lorsque courseWorkType est SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
Contenu soumis lorsque courseWorkType est MULTIPLE_CHOICE_QUESTION. |
RubricGrade
Note définie avec la grille d'évaluation pour le devoir envoyé par l'élève. Il y a au maximum une entrée par critère de la grille d'évaluation.
Représentation JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Champs | |
---|---|
criterionId |
Facultatif. Identifiant du critère. |
levelId |
Facultatif. ID facultatif du niveau sélectionné. Si ce champ est vide, aucun niveau n'a été sélectionné. |
points |
Facultatif. Points facultatifs attribués à ce critère, généralement en fonction du niveau. Les niveaux peuvent contenir ou non des points. Si cette règle n'est pas configurée, aucun point n'a été défini pour ce critère. |
AssignmentSubmission
Devoirs d'élèves pour un devoir.
Représentation JSON |
---|
{
"attachments": [
{
object ( |
Champs | |
---|---|
attachments[] |
Pièces jointes ajoutées par l'élève. Il est possible que les fichiers Drive correspondant à des supports de cours dont le mode de partage est STUDENT_COPY n'existent pas encore si l'élève n'a pas accédé au devoir dans Classroom. Certaines métadonnées de pièces jointes ne sont renseignées que si l'utilisateur à l'origine de la demande est autorisé à y accéder. Les champs "Identifier" et "alternateLink" sont toujours disponibles, mais ce n'est pas toujours le cas d'autres champs, comme le titre. |
Attachement
Pièce jointe ajoutée au devoir.
Lorsque vous créez des pièces jointes, il n'est pas possible de définir le champ form
.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union attachment . Données des pièces jointes. attachment ne peut être qu'un des éléments suivants : |
|
driveFile |
Fichier Google Drive en pièce jointe. |
youTubeVideo |
Vidéo YouTube en pièce jointe. |
link |
Lien en pièce jointe. |
form |
Pièce jointe Google Forms. |
ShortAnswerSubmission
Devoir les élèves pour une question à réponse courte.
Représentation JSON |
---|
{ "answer": string } |
Champs | |
---|---|
answer |
Réponse d'un élève à une question à réponse courte. |
MultipleChoiceSubmission
Travail d'élève pour une question à choix multiples
Représentation JSON |
---|
{ "answer": string } |
Champs | |
---|---|
answer |
Choix de l'élève. |
SubmissionHistory
Historique de l'envoi. Cela inclut actuellement l'historique des états et des notes.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union type . Type de "SubmissionHistory" : peut être StateHistory ou GradeHistory. type ne peut être qu'un des éléments suivants : |
|
stateHistory |
Informations sur l'historique des états de l'envoi, le cas échéant. |
gradeHistory |
L'historique des notes de l'envoi, le cas échéant. |
StateHistory
Historique de chaque état dans lequel cet envoi a été effectué.
Représentation JSON |
---|
{
"state": enum ( |
Champs | |
---|---|
state |
Étape du pipeline de workflow. |
stateTimestamp |
Indique le moment où la soumission est passée à cet état. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
actorUserId |
Enseignant ou élève à l'origine de la modification. |
État
États possibles pour un envoi.
Enums | |
---|---|
STATE_UNSPECIFIED |
Aucun État spécifié. Cet identifiant ne doit jamais être renvoyé. |
CREATED |
La soumission a été créée. |
TURNED_IN |
L'élève a remis son devoir, qui peut servir ou non à un modèle. |
RETURNED |
L'enseignant a rendu le document attribué à l'élève. |
RECLAIMED_BY_STUDENT |
L'élève a rendu le document attribué, puis a choisi d'annuler l'envoi du devoir. Il a ainsi à nouveau le contrôle en tant que propriétaire. |
STUDENT_EDITED_AFTER_TURN_IN |
L'élève a modifié son devoir après l'avoir rendu. Actuellement, cette option n'est utilisée que pour les questions, lorsque l'élève modifie sa réponse. |
GradeHistory
Historique de chaque note pour cet envoi.
Représentation JSON |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
Champs | |
---|---|
pointsEarned |
Numérateur de la note à ce stade dans l'historique des notes soumis. |
maxPoints |
Dénominateur de la note à ce stade dans l'historique des notes soumis. |
gradeTimestamp |
Date de modification de la note du devoir. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
actorUserId |
Enseignant qui a modifié la note. |
gradeChangeType |
Type de modification de note à ce stade dans l'historique des notes envoyées. |
GradeChangeType
Types de modifications possibles de la note.
Enums | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
Aucun type de changement de note spécifié. Cet identifiant ne doit jamais être renvoyé. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
Modification du numérateur de la note temporaire. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
Modification du numérateur de la note attribuée. |
MAX_POINTS_CHANGE |
Changement dans le dénominateur de la note. |
Méthodes |
|
---|---|
|
Renvoie le devoir d'un élève. |
|
Renvoie la liste des devoirs rendus par les élèves que le demandeur est autorisé à consulter, en tenant compte des champs d'application OAuth de la requête. |
|
Modifie les pièces jointes des devoirs envoyés par l'élève. |
|
Met à jour un ou plusieurs champs du devoir envoyé par un élève. |
|
Récupérer un travail d'élève au nom de l'élève qui en est le propriétaire |
|
Renvoie le devoir d'un élève. |
|
Rendre le devoir d'un élève. |