REST Resource: courses.courseWork

Ressource: CourseWork

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)
  },

  // 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.
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.

id

string

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

Supports supplémentaires.

CourseWork ne doit pas contenir plus de 20 éléments matériels.

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)

Code temporel de la création de ce devoir.

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)

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

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

dueDate

object (Date)

Date facultative, en UTC, de la date limite de remise des devoirs pour ce cours. Doit être spécifié si dueTime est spécifié.

dueTime

object (TimeOfDay)

Heure facultative (UTC) pendant laquelle les devoirs doivent être remis pour ce cours. Doit être spécifié si dueDate est spécifié.

scheduledTime

string (Timestamp format)

Code temporel facultatif de la date de publication de ce 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".

maxPoints

number

Note maximale pour ce devoir. Si aucune valeur n'est spécifiée, le devoir est considéré comme n'ayant pas été noté. La valeur doit être un nombre entier non négatif.

workType

enum (CourseWorkType)

Type de devoir.

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

associatedWithDeveloper

boolean

Indique si cet élément de travail du cours est associé au projet de la console développeur à l'origine de la demande.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.

assigneeMode

enum (AssigneeMode)

Mode "Personne responsable" des documents de travail. 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 devoirs. Ce champ n'est défini que si assigneeMode est défini sur INDIVIDUAL_STUDENTS. Si assigneeMode est défini sur INDIVIDUAL_STUDENTS, seuls les élèves spécifiés dans ce champ se voient attribuer les devoirs.

submissionModificationMode

enum (SubmissionModificationMode)

Paramètre permettant de déterminer quand les élèves sont autorisés à modifier des 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éé les documents de travail.

Lecture seule.

topicId

string

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

gradeCategory

object (GradeCategory)

Catégorie à laquelle appartient la note de ce devoir. ne sont présents que lorsqu'une catégorie a été choisie pour les documents de travail. Peut être utilisé pour calculer la note globale.

Lecture seule.

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 du devoir. 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 si 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 le champ workType MULTIPLE_CHOICE_QUESTION. Il ne doit pas être défini autrement.

CourseWorkState

États possibles d'un devoir.

Enums
COURSE_WORK_STATE_UNSPECIFIED Aucun État spécifié. Cet élément n'est jamais renvoyé.
PUBLISHED État du devoir publié. Il s'agit de l'état par défaut.
DRAFT État du devoir qui n'est pas encore publié. Seuls les enseignants du cours et les administrateurs de domaine peuvent voir les devoirs dans cet état.
DELETED État du devoir qui a été publié, mais qui est désormais supprimé. Seuls les enseignants du cours et les administrateurs de domaine peuvent voir les devoirs dans cet état. Les tâches présentant 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 spécifié. Cet élément n'est jamais renvoyé.
MODIFIABLE_UNTIL_TURNED_IN Les devoirs peuvent être modifiés avant qu'ils ne soient rendus.
MODIFIABLE Les contenus soumis peuvent être modifiés à tout moment.

Assignment

Informations supplémentaires pour 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 des élèves. Ce champ n'est renseigné que pour les enseignants et les administrateurs des 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 des devoirs.

delete

Supprime un devoir.

get

Renvoie des devoirs.

getAddOnContext

Obtient les métadonnées des modules complémentaires Classroom dans le contexte d'une publication spécifique.

list

Affiche une liste des devoirs que le demandeur est autorisé à consulter.

modifyAssignees

Modifie le mode des responsables et les options des devoirs.

patch

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