REST Resource: courses.courseWork

Ressource : CourseWork

Travaux et devoirs créés par un enseignant pour les élèves du cours.

Représentation JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.
id

string

Identifiant attribué par Classroom à ce devoir, unique par cours.

Lecture seule.
title

string

Titre de ce devoir. Le titre doit être une chaîne UTF-8 valide contenant entre 1 et 3 000 caractères.
description

string

Description facultative de ce devoir. Si elle est définie, la description doit être une chaîne UTF-8 valide ne contenant pas plus de 30 000 caractères.
materials[]

object (Material)

Autres ressources.

Le travail et devoir ne doit pas comporter plus de 20 supports.
state

enum (CourseWorkState)

État de ce devoir. Si aucune valeur n'est spécifiée, l'état par défaut est DRAFT.
creationTime

string (Timestamp format)

Horodatage de la création de ce devoir.

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)

Horodatage de la dernière modification apportée à ce devoir.

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".
dueDate

object (Date)

Date facultative, au format UTC, à laquelle les devoirs de ce cours doivent être rendus. Ce champ doit être spécifié si dueTime est spécifié.
dueTime

object (TimeOfDay)

Heure de la journée (facultative), au format UTC, à laquelle les devoirs doivent être rendus. Ce champ doit être spécifié si dueDate est spécifié.
scheduledTime

string (Timestamp format)

Code temporel facultatif indiquant quand ce devoir doit être publié.

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".
maxPoints

number

Note maximale pour ce devoir. Si la valeur est zéro ou n'est pas spécifiée, le devoir est considéré comme non noté. Il doit s'agir d'un nombre entier non négatif.
workType

enum (CourseWorkType)

Type de ce devoir.

Le type est défini lors de la création du devoir et ne peut pas être modifié.
associatedWithDeveloper

boolean

Indique si ce devoir est associé au projet de la Developer Console qui effectue la requête.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.
assigneeMode

enum (AssigneeMode)

Mode d'attribution du document de travail. Si elle n'est pas spécifiée, la valeur par défaut est ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identifiants des élèves ayant accès au devoir. Ce champ n'est défini que si assigneeMode est défini sur INDIVIDUAL_STUDENTS. Si la valeur de assigneeMode est INDIVIDUAL_STUDENTS, seuls les élèves spécifiés dans ce champ se voient attribuer le devoir.
submissionModificationMode

enum (SubmissionModificationMode)

Paramètre permettant de déterminer quand les élèves sont autorisés à modifier leurs devoirs. Si elle n'est pas spécifiée, la valeur par défaut est MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identifiant de l'utilisateur qui a créé le devoir.

Lecture seule.
topicId

string

Identifiant du thème auquel ce document de travail est associé. Doit correspondre à un thème existant dans le cours.
gradeCategory

object (GradeCategory)

Catégorie à laquelle la note de ce devoir contribue. Présent uniquement lorsqu'une catégorie a été choisie pour le document de travail. Peut être utilisé pour calculer la note globale.

Lecture seule.
previewVersion

enum (PreviewVersion)

Uniquement en sortie. Version preview de l'API utilisée pour récupérer cette ressource.
learningGoals[]

object (LearningGoal)

Facultatif.

Références à tous les objectifs d'apprentissage associés à ce devoir. Un devoir peut comporter au maximum 10 objectifs d'apprentissage. Ce champ n'est renseigné que si le previewVersion approprié est défini.
Informations supplémentaires spécifiques à un type de devoir. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
assignment

object (Assignment)

Détails de la tâche. Ce champ n'est renseigné que lorsque workType est défini sur ASSIGNMENT.

Lecture seule.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Détails de la question à choix multiples. Pour les opérations de lecture, ce champ n'est renseigné que lorsque workType est défini sur MULTIPLE_CHOICE_QUESTION. Pour les opérations d'écriture, ce champ doit être spécifié lors de la création d'un devoir avec un workType de MULTIPLE_CHOICE_QUESTION, et ne doit pas être défini autrement.
Fin des champs mutuellement exclusifs.
gradingPeriodId

string

Identifiant de la période de notation associée au devoir.

  • Lors de la création, si l'ID de la période de notation n'est pas spécifié, il sera défini en fonction de la dueDate (ou de la scheduledTime si aucune dueDate n'est définie).
  • Pour indiquer qu'il n'y a aucune association à une période de notation, définissez ce champ sur une chaîne vide ("").
  • S'il est spécifié, il doit correspondre à l'ID d'une période de notation existante dans le cours.

CourseWorkState

États possibles d'un devoir.

Enums
COURSE_WORK_STATE_UNSPECIFIED Aucun état spécifié. Cette valeur n'est jamais renvoyée.
PUBLISHED État d'un travail qui a été publié. Il s'agit de l'état par défaut.
DRAFT État d'un travail qui n'est pas encore publié. Les devoirs dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine.
DELETED État d'un travail qui a été publié, mais qui est maintenant supprimé. Les devoirs dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine. Les tâches dans cet état sont supprimées après un certain temps.

SubmissionModificationMode

Modes de modification possibles pour les devoirs des élèves.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Aucun mode de modification spécifié. Cette valeur n'est jamais renvoyée.
MODIFIABLE_UNTIL_TURNED_IN Les devoirs peuvent être modifiés avant d'être rendus.
MODIFIABLE Les envois peuvent être modifiés à tout moment.

Assignment

Informations supplémentaires sur les devoirs.

Représentation JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Champs
studentWorkFolder

object (DriveFolder)

Dossier Drive dans lequel sont placées les pièces jointes des devoirs rendus par les élèves. Ce champ n'est renseigné que pour les enseignants et les administrateurs du cours.

MultipleChoiceQuestion

Informations supplémentaires pour les questions à choix multiples.

Représentation JSON 
{
  "choices": [
    string
  ]
}
Champs
choices[]

string

Choix possibles.

Méthodes

create

 créer des travaux et devoirs ;

delete

 Supprime un devoir.

get

 Renvoie un devoir.

getAddOnContext

 Récupère les métadonnées des modules complémentaires Classroom dans le contexte d'un post spécifique.

list

 Renvoie la liste des devoirs que le demandeur est autorisé à consulter.

modifyAssignees

 Modifie le mode et les options d'attribution d'un devoir.

patch

 Met à jour un ou plusieurs champs d'un devoir.