REST Resource: courses.courseWork.studentSubmissions

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 (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'une méthode unique parmi les envois pour le devoir concerné.

Lecture seule.

userId

string

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

Lecture seule.

creationTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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: "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 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

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 elles sont arrondies à deux chiffres après la virgule.

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.

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 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 "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

assignedRubricGrades

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

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 "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

courseWorkType

enum (CourseWorkType)

Type de devoir auquel cet envoi est destiné.

Lecture seule.

associatedWithDeveloper

boolean

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

Pour en savoir plus, consultez courseWork.create.

Lecture seule.

submissionHistory[]

object (SubmissionHistory)

Historique de l'envoi (y compris l'historique de l'état et des notes)

Lecture seule.

previewVersion

enum (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

object (AssignmentSubmission)

Contenu soumis lorsque courseWorkType est défini sur ASSIGNMENT.

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

shortAnswerSubmission

object (ShortAnswerSubmission)

Contenu soumis lorsque courseWorkType est SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (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

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 à 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 (Attachment)
    }
  ]
}
Champs
attachments[]

object (Attachment)

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

Devoir les élèves 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'é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 StateHistory ou GradeHistory. type ne peut être qu'un des éléments suivants :
stateHistory

object (StateHistory)

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

gradeHistory

object (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 (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Champs
state

enum (State)

Étape du pipeline de workflow.

stateTimestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

actorUserId

string

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 (GradeChangeType)
}
Champs
pointsEarned

number

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

maxPoints

number

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

gradeTimestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

actorUserId

string

Enseignant qui a modifié la note.

gradeChangeType

enum (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

get

Renvoie le devoir d'un élève.

list

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.

modifyAttachments

Modifie les pièces jointes des devoirs envoyés par l'élève.

patch

Met à jour un ou plusieurs champs du devoir envoyé par un élève.

reclaim

Récupérer un travail d'élève au nom de l'élève qui en est le propriétaire

return

Renvoie le devoir d'un élève.

turnIn

Rendre le devoir d'un élève.