REST Resource: courses.courseWork

Ressource : CourseWork

Devoir créé 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),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.
id

string

Identifiant attribué à ce devoir dans Classroom, 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)

Ressources supplémentaires

Un devoir ne doit pas comporter plus de 20 éléments de cours.
state

enum (CourseWorkState)

État de ce devoir. Si aucun état n'est spécifié, la valeur 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)

Code temporel 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, en UTC, à laquelle les devoirs de ce cours doivent être rendus. Cette valeur doit être spécifiée si dueTime est spécifié.
dueTime

object (TimeOfDay)

Heure de la journée (facultative, en UTC) à laquelle les devoirs de ce cours doivent être rendus. Cette valeur doit être spécifiée si dueDate est spécifié.
scheduledTime

string (Timestamp format)

Code temporel facultatif indiquant la date de publication de ce devoir.

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 nulle ou non 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 devoir.

Le type est défini lorsque le devoir est créé et ne peut pas être modifié.
associatedWithDeveloper

boolean

Indique si le devoir est associé au projet de la console Developer qui envoie la requête.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.
assigneeMode

enum (AssigneeMode)

Mode de l'élève auquel le cours est attribué. Si aucune valeur n'est spécifiée, la valeur par défaut est ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identifiants des élèves ayant accès aux cours. Ce champ n'est défini que si assigneeMode est INDIVIDUAL_STUDENTS. Si assigneeMode est défini sur INDIVIDUAL_STUDENTS, seuls les élèves spécifiés dans ce champ sont affectés au devoir.
submissionModificationMode

enum (SubmissionModificationMode)

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

string

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

Lecture seule.
topicId

string

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

object (GradeCategory)

Catégorie à laquelle la note de ce devoir contribue. N'est présent que si une catégorie a été choisie pour le cours. 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.
Champ d'union details. Informations supplémentaires spécifiques à un type de devoir. details ne peut être qu'un des éléments suivants :
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 d'une 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. Dans les autres cas, il ne doit pas être défini.
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 est défini en fonction de dueDate (ou de scheduledTime si aucun dueDate n'est défini).
  • Pour indiquer qu'il n'y a aucune association à une période de notation, définissez ce champ sur une chaîne vide ("").
  • Si ce paramètre est spécifié, il doit correspondre à un ID de période de notation existant 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 devoir publié. Il s'agit de l'état par défaut.
DRAFT État des devoirs qui n'ont pas encore été publiés. Les devoirs dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine.
DELETED État d'un devoir qui a été publié, mais qui est désormais 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 au bout d'un certain temps.

SubmissionModificationMode

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

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Aucun mode de modification n'a été spécifié. Cette valeur n'est jamais renvoyée.
MODIFIABLE_UNTIL_TURNED_IN Vous pouvez modifier les devoirs avant de les rendre.
MODIFIABLE Vous pouvez modifier vos contributions à 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. Cette valeur n'est renseignée 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ée un devoir.

delete

 Supprime un devoir.

get

 Rend un devoir.

getAddOnContext

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