- Ressource: StudentSubmission
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RubricGrade
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- AssignmentSubmission
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Pièce jointe
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- ShortAnswerSubmission
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- MultipleChoiceSubmission
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- SubmissionHistory
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- StateHistory
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- État
- GradeHistory
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- GradeChangeType
- Méthodes
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 ( |
Champs | |
---|---|
courseId |
Identifiant du cours. En lecture seule. |
courseWorkId |
Identifiant du devoir de cours correspondant. En lecture seule. |
id |
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 |
Identifiant de l'élève propriétaire de cet envoi. En lecture seule. |
creationTime |
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 : |
updateTime |
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 : |
state |
État de cet envoi. En lecture seule. |
late |
Indique si cet envoi est en retard. En lecture seule. |
draftGrade |
(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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
Lien absolu vers le devoir dans l'interface utilisateur Web de Classroom. En lecture seule. |
courseWorkType |
Type de devoir auquel cet envoi est destiné. En lecture seule. |
associatedWithDeveloper |
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 En lecture seule. |
submissionHistory[] |
L'historique des envois (y compris l'historique des états et des notes) En lecture seule. |
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 |
Contenu soumis lorsque courseWorkType est défini sur ASSIGNMENT. Les élèves peuvent modifier ce contenu avec |
shortAnswerSubmission |
Contenu soumis lorsque la valeur courseWorkType est SHORT_ANSWER_QUESTION. |
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 |
Facultatif. Identifiant du critère. |
levelId |
Facultatif. ID facultatif du niveau sélectionné. Si ce champ est vide, aucun niveau n'a été sélectionné. |
points |
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 ( |
Champs | |
---|---|
attachments[] |
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 |
Champs | |
---|---|
Champ d'union attachment . Données des pièces jointes. attachment ne peut être qu'un des éléments suivants : |
|
driveFile |
Fichier Google Drive en pièce jointe. |
youTubeVideo |
Vidéo YouTube en pièce jointe. |
link |
Lien en pièce jointe. |
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 |
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 |
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 |
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 |
Informations sur l'historique de l'état de l'envoi, le cas échéant. |
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 ( |
Champs | |
---|---|
state |
Étape du pipeline du workflow. |
stateTimestamp |
É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 : |
actorUserId |
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 ( |
Champs | |
---|---|
pointsEarned |
Numérateur de la note à ce moment précis dans l'historique des notes envoyées |
maxPoints |
Dénominateur de la note dans l'historique des notes d'envoi. |
gradeTimestamp |
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 : |
actorUserId |
L'enseignant qui a apporté la modification de la note. |
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 |
|
---|---|
|
Renvoie le devoir d'un élève. |
|
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. |
|
Modifie les pièces jointes du devoir des élèves. |
|
Met à jour un ou plusieurs champs du travail d'un élève. |
|
Permet de récupérer le devoir d'un élève au nom de l'élève qui en est le propriétaire. |
|
Renvoie le devoir d'un élève. |
|
Remet le devoir d'un élève. |