REST Resource: courses.courseWork.studentSubmissions

Ressource: StudentSubmission

Devoirs d'élèves.

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

Il est possible qu'il n'y ait pas d'heure de création ni d'heure de mise à jour pour les devoirs des élèves auxquels il n'a jamais été accédé (state = NEW).

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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.

courseWorkId

string

Identifiant du devoir auquel il correspond.

Lecture seule.

id

string

Identifiant attribué par Classroom à l'envoi de l'élève. Il s'agit d'un cas unique parmi les devoirs du 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. Ce paramètre peut être défini sur "non" si l'élève n'a pas accédé à cet élément.

Lecture seule.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Date et heure de la dernière mise à jour de cet envoi. Ce paramètre peut être défini sur "non" si l'élève n'a pas accédé à cet élément.

Lecture seule.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

state

enum (SubmissionState)

État de cet envoi.

Lecture seule.

late

boolean

Indique si cet envoi est en retard.

Lecture seule.

draftGrade

number

Note en attente facultative. Si elle n'est pas définie, 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 sont arrondies à deux décimales.

Cette information n'est visible que par les enseignants du cours et peut être modifiée par eux.

assignedGrade

number

Note facultative. Si elle n'est pas définie, 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 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 travail et utilisée pour noter cet envoi d'élève.

Cet ID est vide s'il n'y a pas de grille d'évaluation. Cet ID reflète la grille de notation actuellement active. Il change si les enseignants suppriment et recréent la grille.

Lecture seule.

draftRubricGrades

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

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

Cette carte est vide si aucune grille d'évaluation n'est associée à ce travail de cours ou si une grille d'évaluation est associée, 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 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))

Les notes attribuées en fonction des critères de la grille d'évaluation

Cette carte est vide si aucune grille d'évaluation n'est associée à ce travail de cours ou si une grille d'évaluation est associée, 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 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 pour lequel cet envoi est destiné.

Lecture seule.

associatedWithDeveloper

boolean

Indique si cet envoi d'élève est associé au projet de la console de développement à l'origine de la requête.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.

submissionHistory[]

object (SubmissionHistory)

L'historique de l'envoi (inclut l'historique de l'état et des notes)

Lecture seule.

previewVersion

enum (PreviewVersion)

Uniquement en sortie. Version preview de l'API. Ce paramètre doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Champ d'union content. Contenu de l'envoi. 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

object (AssignmentSubmission)

Contenu de l'envoi lorsque courseWorkType est "DEVOIR".

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

shortAnswerSubmission

object (ShortAnswerSubmission)

Contenu de l'envoi lorsque le type de devoir est "SHORT_ANSWER_QUESTION".

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenu de l'envoi lorsque le type de cours est MULTIPLE_CHOICE_QUESTION.

RubricGrade

Note attribuée à l'élève à l'aide d'une grille d'évaluation Il ne peut y avoir qu'une seule entrée par critère de la 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 à ce critère, généralement en fonction du niveau. Les niveaux peuvent ou non comporter des points. Si ce paramètre n'est pas défini, 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. Les fichiers Drive correspondant aux éléments dont le mode de partage est "STUDENT_COPY" peuvent ne pas encore exister si l'élève n'a pas encore accédé au devoir dans Classroom.

Certaines métadonnées d'une pièce jointe 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 il se peut que d'autres (par exemple, "title") ne le soient pas.

Pièce jointe

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

Lorsque vous créez des pièces jointes, il n'est pas possible de définir le champ form.

Représentation JSON
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Champs
Champ d'union attachment. Données de la pièce jointe. attachment ne peut être qu'un des éléments suivants :
driveFile

object (DriveFile)

Pièce jointe Google Drive

youTubeVideo

object (YouTubeVideo)

Vidéo YouTube jointe.

form

object (Form)

Pièce jointe Google Forms

ShortAnswerSubmission

Travail 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

Travail 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
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Champs
Champ d'union type. Type de SubmissionHistory, peut être l'un des éléments suivants : StateHistory, GradeHistory. type ne peut être qu'un des éléments suivants :
stateHistory

object (StateHistory)

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

gradeHistory

object (GradeHistory)

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

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 l'envoi est passé à cet état.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

actorUserId

string

L'enseignant ou l'élève à l'origine de la modification.

État

États possibles d'une soumission.

Enums
STATE_UNSPECIFIED Aucun état spécifié. Cette valeur ne devrait jamais être renvoyée.
CREATED L'envoi a été créé.
TURNED_IN L'élève a remis un document qui lui a été demandé, 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, puis choisi de l'annuler, ce qui lui a redonné le contrôle en tant que propriétaire.
STUDENT_EDITED_AFTER_TURN_IN L'élève a modifié son devoir après l'avoir envoyé. Actuellement, il n'est utilisé que par les questions, lorsque l'élève modifie sa réponse.

GradeHistory

Historique de chaque note attribuée à cet envoi.

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

number

Numérateur de la note à ce stade dans l'historique des notes des devoirs.

maxPoints

number

Dénominateur de la note à ce stade dans l'historique des notes des devoirs.

gradeTimestamp

string (Timestamp format)

Date et heure auxquelles la note de l'envoi a été modifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

actorUserId

string

L'enseignant qui a modifié la note.

gradeChangeType

enum (GradeChangeType)

Type de modification de la note à ce stade dans l'historique des notes de remise.

GradeChangeType

Types de modifications de note possibles.

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

Méthodes

get

Renvoie le devoir d'un élève.

list

Renvoie la liste des devoirs rendus par les élèves que l'utilisateur est autorisé à consulter, en tenant compte des portées OAuth de la requête.

modifyAttachments

Modifie les pièces jointes des devoirs des élèves.

patch

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

reclaim

Réclame un devoir d'élève au nom de l'élève qui en est le propriétaire.

return

Renvoie le devoir d'un élève.

turnIn

Rend un devoir.