REST Resource: courses.courseWork.studentSubmissions

Ressource : StudentSubmission

Devoir rendu par un élève.

Les éléments StudentSubmission sont générés lorsqu'un élément CourseWork est créé.

Les devoirs rendus par les élèves qui n'ont jamais été consultés (c'est-à-dire avec state = NEW) peuvent ne pas avoir 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 (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.
courseWorkId

string

Identifiant du devoir auquel cela correspond.

Lecture seule.
id

string

Identifiant attribué par Classroom pour le devoir de l'élève. Il est unique parmi les devoirs rendus pour le cours concerné.

Lecture seule.
userId

string

Identifiant de l'élève propriétaire de ce devoir.

Lecture seule.
creationTime

string (Timestamp format)

Heure de création de cet envoi. Il est possible que ce champ ne soit pas défini si l'élève n'a pas accédé à cet élément.

Lecture seule.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Heure de la dernière mise à jour de cet envoi. Il est possible que ce champ ne soit pas défini si l'élève n'a pas accédé à cet élément.

Lecture seule.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

État de cet envoi.

Lecture seule.
late

boolean

Indique si l'envoi est en retard.

Lecture seule.
draftGrade

number

Note en attente facultative. Si ce champ n'est pas défini, 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 décimales.

Seuls les enseignants du cours peuvent voir et modifier cette information.
assignedGrade

number

Note facultative. Si ce champ n'est pas défini, 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 décimales.

Seuls les enseignants du cours peuvent modifier ce paramètre.
rubricId

string

Uniquement en sortie. Identifiant de la grille d'évaluation actuellement associée à ce devoir et utilisée pour noter ce devoir d'élève.

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

map (key: string, value: object (RubricGrade))

Notes de la grille d'évaluation en attente, basées sur les critères de la grille d'évaluation.

Cette carte est vide si aucun critère n'est associé à ce devoir, ou si un critère est associé, mais qu'aucune note n'a été définie pour un critère. Les entrées ne sont renseignées que pour les notes qui ont été définies. Clé : ID du critère de la grille d'évaluation.

Lecture seule.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Notes attribuées en fonction des critères de la grille d'évaluation.

Cette carte est vide si aucun devoir n'est associé à une grille d'évaluation, ou si une grille d'évaluation est associée, 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 du critère de la grille d'évaluation.

Lecture seule.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Type de devoir auquel ce devoir remis est destiné.

Lecture seule.
associatedWithDeveloper

boolean

Indique si ce devoir d'élève est associé au projet de la Developer Console à l'origine de la requête.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.
submissionHistory[]

object (SubmissionHistory)

Historique du devoir (inclut l'historique des états et des notes).

Lecture seule.
previewVersion

enum (PreviewVersion)

Uniquement en sortie. Version preview de l'API. Vous devez définir cette valeur pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.
Contenu de l'envoi. Le type spécifique dépend de la valeur de course_work_type. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
assignmentSubmission

object (AssignmentSubmission)

Contenu du devoir lorsque courseWorkType est défini sur ASSIGNMENT.

Les élèves peuvent modifier ce contenu à l'aide de studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Contenu du devoir lorsque courseWorkType est SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenu du devoir lorsque le type de travail est MULTIPLE_CHOICE_QUESTION.
Fin des champs mutuellement exclusifs.

RubricGrade

Une note de grille d'évaluation définie pour le devoir de l'élève. Il n'y a qu'une seule entrée par critère de grille d'évaluation.

Représentation JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Champs
criterionId

string

Facultatif. ID du critère.
levelId

string

Facultatif. ID de niveau facultatif du niveau sélectionné. Si ce champ est vide, aucun niveau n'a été sélectionné.
points

number

Facultatif. Points facultatifs attribués pour ce critère, généralement en fonction du niveau. Les niveaux peuvent ou non avoir des points. Si cette valeur n'est pas définie, aucun point n'a été défini pour ce critère.

AssignmentSubmission

Devoir d'un élève.

Représentation JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Champs
attachments[]

object (Attachment)

Pièces jointes ajoutées par l'élève. Il est possible que les fichiers Drive correspondant à des supports 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èce jointe ne sont renseignées que si l'utilisateur demandeur est autorisé à y accéder. Les champs "identifier" et "alternateLink" sont toujours disponibles, mais d'autres (par exemple, "title") peuvent ne pas l'être.

Pièce jointe

Pièce jointe ajoutée au devoir de l'élève.

Lors de la création de pièces jointes, il n'est pas possible de définir le champ form.

Représentation JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Champs
Données de la pièce jointe. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
driveFile

object (DriveFile)

Pièce jointe Google Drive.
youTubeVideo

object (YouTubeVideo)

Vidéo YouTube en pièce jointe.
form

object (Form)

Pièce jointe Google Forms.
Fin des champs mutuellement exclusifs.

ShortAnswerSubmission

Devoir d'un élève pour une question à réponse courte.

Représentation JSON 
{
  "answer": string
}
Champs
answer

string

Réponse d'un élève à une question à réponse courte.

MultipleChoiceSubmission

Devoir d'un élève pour une question à choix multiples.

Représentation JSON 
{
  "answer": string
}
Champs
answer

string

Choix de l'élève.

SubmissionHistory

Historique de l'envoi. Cela inclut actuellement l'historique des états et des notes.

Représentation JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Champs
Type de SubmissionHistory, qui peut être StateHistory ou GradeHistory. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
stateHistory

object (StateHistory)

Informations sur l'historique des états de l'envoi, le cas échéant.
gradeHistory

object (GradeHistory)

Informations sur l'historique des notes du devoir, le cas échéant.
Fin des champs mutuellement exclusifs.

StateHistory

Historique de chaque état de cet envoi.

Représentation JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Champs
state

enum (State)

Étape du pipeline de workflow.
stateTimestamp

string (Timestamp format)

Date à laquelle la demande est passée à cet état.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
actorUserId

string

L'enseignant ou l'élève qui a effectué la modification.

État

États possibles d'un envoi.

Enums
STATE_UNSPECIFIED Aucun état spécifié. Cette valeur ne doit jamais être renvoyée.
CREATED L'envoi a été créé.
TURNED_IN L'élève a rendu un document attribué, qui peut être un modèle ou non.
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, ce qui lui a permis de redevenir propriétaire du document.
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 par les questions, lorsque l'élève modifie sa réponse.

GradeHistory

Historique de chaque note attribuée à ce devoir.

Représentation JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Champs
pointsEarned

number

Numérateur de la note à ce moment-là dans l'historique des notes du devoir.
maxPoints

number

Dénominateur de la note à ce moment-là dans l'historique des notes du devoir.
gradeTimestamp

string (Timestamp format)

Date et heure de modification de la note du devoir.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
actorUserId

string

L'enseignant qui a modifié la note.
gradeChangeType

enum (GradeChangeType)

Type de modification de la note à ce moment-là dans l'historique des notes du devoir.

GradeChangeType

Types de modification de note possibles.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Aucun type de modification de note n'a été spécifié. Cette valeur ne doit jamais être renvoyée.
DRAFT_GRADE_POINTS_EARNED_CHANGE Modification du numérateur de la note provisoire.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Une modification du numérateur de la note attribuée.
MAX_POINTS_CHANGE Modification du dénominateur de la note.

Méthodes

get

 Renvoie un devoir d'élève.

list

 Renvoie la liste des devoirs d'élèves que le demandeur est autorisé à consulter, en tenant compte des champs d'application OAuth de la requête.

modifyAttachments

 Modifie les pièces jointes du devoir d'un élève.

patch

 Met à jour un ou plusieurs champs d'un devoir d'élève.

reclaim

 Récupère un devoir au nom de l'élève qui en est propriétaire.

return

 Renvoie un devoir d'élève.

turnIn

 Remet un devoir d'élève.