REST Resource: courses.courseWork.studentSubmissions

Ressource : StudentSubmission

Devoir d'un élève.

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

Il est possible que les devoirs des élèves qui n'ont jamais été consultés (c'est-à-dire dont l'état est state = NOUVEAU) n'aient pas de date de création ni de date de modification.

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 cela correspond.

Lecture seule.
id

string

Identifiant attribué par Classroom pour le devoir de l'élève. Il est 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 cette demande. Cette valeur peut être non définie 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)

Date et heure de la dernière mise à jour de cette demande. Cette valeur peut être non définie 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 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é attribuée. 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 voir et modifier ces informations.
assignedGrade

number

Note facultative. Si elle n'est pas définie, aucune note n'a été attribuée. 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 devoir et utilisée pour noter le devoir de cet élève.

Cet ID est vide si aucune grille d'évaluation n'est associée. Cet ID reflète la grille d'évaluation actuellement active. Il change si les enseignants suppriment et recréent la grille.

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 associée à ce devoir ou si une grille d'évaluation est associée, mais qu'aucune note n'a été attribuée à aucun critère. Les entrées ne sont renseignées que pour les notes qui ont été attribuées. 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 à la grille d'évaluation en fonction des critères de la grille.

Cette carte est vide si aucune grille d'évaluation n'est associée à ce devoir ou si une grille d'évaluation est associée, mais qu'aucune note n'a été attribuée à un critère. Les entrées ne sont renseignées que pour les notes qui ont été attribuées. 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 cette remise est associée.

Lecture seule.
associatedWithDeveloper

boolean

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

Pour en savoir plus, consultez courseWork.create.

Lecture seule.
submissionHistory[]

object (SubmissionHistory)

Historique de l'envoi (y compris l'historique de l'état et de la note).

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 la demande. 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 la remise lorsque courseWorkType est défini sur ASSIGNMENT.

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

object (ShortAnswerSubmission)

Contenu de la réponse lorsque courseWorkType est SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenu de la réponse lorsque courseWorkType est défini sur MULTIPLE_CHOICE_QUESTION.

RubricGrade

Note par rubrique définie pour le devoir de l'élève. Il ne peut y avoir 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 elle 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 aucune valeur n'est définie, aucun point n'a été attribué à ce critère.

AssignmentSubmission

Devoirs des é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 aux ressources 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 qui en fait la demande 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 d'un élève.

Lorsque vous créez des pièces jointes, vous ne pouvez pas 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 de fichier Google Drive.
youTubeVideo

object (YouTubeVideo)

Pièce jointe vidéo YouTube.
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. Les valeurs possibles sont StateHistory et 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)

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

StateHistory

Historique de chaque état dans lequel cette demande a été placée.

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

enum (State)

Étape du pipeline de workflow.
stateTimestamp

string (Timestamp format)

Date et heure auxquelles 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'une demande.

Enums
STATE_UNSPECIFIED Aucun état spécifié. Cette valeur ne devrait jamais être renvoyée.
CREATED La demande a été créée.
TURNED_IN L'élève a remis un document qui lui a été attribué. Il peut s'agir ou non d'un modèle.
RETURNED L'enseignant a renvoyé le document attribué à l'élève.
RECLAIMED_BY_STUDENT L'élève a rendu le document qui lui avait été attribué, puis a choisi d'annuler l'envoi du devoir, 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 remis. Actuellement, cette propriété n'est utilisée que par les questions, lorsque l'élève modifie sa réponse.

GradeHistory

Historique de chaque note attribuée pour cet 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 de l'envoi.
maxPoints

number

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

string (Timestamp format)

Date et heure de la modification de la note de l'envoi.

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 de la remise.

GradeChangeType

Types de modifications de notes possibles.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Aucun type de modification de note n'a été spécifié. Cette valeur ne devrait jamais être renvoyée.
DRAFT_GRADE_POINTS_EARNED_CHANGE Une 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 rendus par les élèves que le demandeur est autorisé à consulter, en tenant compte des niveaux d'accès 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 d'élève au nom de l'élève qui en est propriétaire.

return

 Renvoie un devoir d'élève.

turnIn

 Rend un devoir d'élève.