REST Resource: courses.courseWork.studentSubmissions

Ressource: StudentSubmission

Devoirs rendus par les élèves

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

Les devoirs remis par un élève qui n'ont jamais été consultés (c'est-à-dire avec state = NOUVEAU) peuvent ne pas avoir d'heure de création ou 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),

  // 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.

En lecture seule.

courseWorkId

string

Identifiant du devoir de cours correspondant.

En lecture seule.

id

string

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

En lecture seule.

userId

string

Identifiant de l'élève propriétaire de cet envoi.

En lecture seule.

creationTime

string (Timestamp format)

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.

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

Heure de la dernière mise à jour de cet envoi. Cette règle peut être désactivée si l'élève n'a pas accédé à cet élément.

En 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.

En lecture seule.

late

boolean

Indique si cet envoi est en retard.

En lecture seule.

draftGrade

number

(Facultatif) Note en attente 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 arrondies à deux décimales.

Seuls les enseignants du cours peuvent voir et modifier ces informations.

assignedGrade

number

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 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 le travail de cet élève.

S'il n'y a pas de grille d'évaluation, cet ID est vide. Cet ID correspond à la grille d'évaluation actuellement active. elle est modifiée si les enseignants suppriment et recréent la grille d'évaluation.

En lecture seule.

draftRubricGrades

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

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

Cette carte est vide si aucune grille d'évaluation n'est jointe à ce devoir ou si une grille d'évaluation est jointe, mais qu'aucune note n'a été définie pour un critère. Les entrées sont renseignées uniquement pour les notes déjà définies. Clé: ID de critère de la grille d'évaluation.

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

Attribuer des notes en fonction des critères de la grille d'évaluation

Cette carte est vide si aucune grille d'évaluation n'est jointe à ce devoir ou si une grille d'évaluation est jointe, mais qu'aucune note n'a été définie pour un critère. Les entrées sont renseignées uniquement pour les notes déjà définies. Clé: ID de critère de la grille d'évaluation.

En 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 cet envoi est destiné.

En lecture seule.

associatedWithDeveloper

boolean

Indique si l'envoi de cet élève est associé au projet de la Developer Console à l'origine de la demande.

Pour en savoir plus, consultez courseWork.create.

En lecture seule.

submissionHistory[]

object (SubmissionHistory)

L'historique des envois (y compris l'historique des états et des notes)

En lecture seule.

previewVersion

enum (PreviewVersion)

Uniquement en sortie. Version preview de l'API. Il 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 soumis lorsque courseWorkType est défini sur ASSIGNMENT.

Les élèves peuvent modifier ce contenu avec studentSubmissions.modifyAttachments.

shortAnswerSubmission

object (ShortAnswerSubmission)

Contenu soumis lorsque la valeur courseWorkType est SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenu soumis lorsque la valeur courseWorkType est MULTIPLE_CHOICE_QUESTION.

RubricGrade

Note définie pour le devoir de l'élève dans une grille d'évaluation. Il y a au maximum une entrée par critère de grille d'évaluation.

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

string

Facultatif. Identifiant du critère.

levelId

string

Facultatif. ID 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 basés sur le niveau. Les niveaux peuvent comporter 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

Le devoir d'un élève pour un devoir.

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 des 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 "AlternativeLink" sont toujours disponibles, mais ce n'est pas toujours le cas pour d'autres champs (par exemple, "title").

Pièce jointe

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

Vous ne pouvez pas définir le champ form lorsque vous créez des pièces jointes.

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 des pièces jointes. attachment ne peut être qu'un des éléments suivants :
driveFile

object (DriveFile)

Fichier Google Drive en pièce jointe.

youTubeVideo

object (YouTubeVideo)

Vidéo YouTube en pièce jointe.

form

object (Form)

Pièce jointe Google Forms.

ShortAnswerSubmission

L'élève doit répondre à une question à réponse courte.

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

string

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

MultipleChoiceSubmission

L'élève doit répondre à 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. Il peut s'agir de StateHistory ou GradeHistory. type ne peut être qu'un des éléments suivants :
stateHistory

object (StateHistory)

Informations sur l'historique de l'état 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 dans lequel se trouve cet envoi.

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

enum (State)

Étape du pipeline du workflow.

stateTimestamp

string (Timestamp format)

État de l'envoi.

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 qui a apporté la modification.

État

États possibles d'un envoi.

Enums
STATE_UNSPECIFIED Aucun État spécifié. Il ne doit jamais être renvoyé.
CREATED La soumission a bien été créée.
TURNED_IN L'élève a rendu un document qui lui a été attribué. Il peut s'agir ou non d'un modèle.
RETURNED L'enseignant a rendu le document attribué à l'élève.
RECLAIMED_BY_STUDENT L'élève a rendu le document qui lui a été attribué, puis a choisi d'annuler l'envoi. le devoir, ce qui donne à l'élève le contrôle à nouveau en tant que propriétaire.
STUDENT_EDITED_AFTER_TURN_IN L'élève a modifié son devoir après l'avoir remis. Actuellement, cette option n'est utilisée que pour les questions, lorsque l'élève modifie sa réponse.

GradeHistory

Historique de chaque note de 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 moment précis dans l'historique des notes envoyées

maxPoints

number

Dénominateur de la note dans l'historique des notes d'envoi.

gradeTimestamp

string (Timestamp format)

Date de modification de la note du devoir.

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 apporté la modification de la note.

gradeChangeType

enum (GradeChangeType)

Type de changement de note à ce moment dans l'historique des notes d'envoi.

GradeChangeType

Types de modifications possibles des notes.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Aucun type de changement de note spécifié. Il 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 du dénominateur de la note.

Méthodes

get

Renvoie le devoir d'un élève.

list

Renvoie la liste des devoirs remis par les é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 des élèves.

patch

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

reclaim

Permet de récupérer le devoir d'un élève au nom de l'élève qui en est le propriétaire.

return

Renvoie le devoir d'un élève.

turnIn

Remet le devoir d'un élève.