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é par Classroom à ce devoir, unique par cours.

Lecture seule.
title

string

Titre du 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 travail de cours. Si elle est définie, la description doit être une chaîne UTF-8 valide ne comportant pas plus de 30 000 caractères.
materials[]

object (Material)

Autres ressources

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

enum (CourseWorkState)

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

string (Timestamp format)

Horodatage de création de ce travail de cours.

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 : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Code temporel de la dernière modification de ce travail de cours.

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 : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
dueDate

object (Date)

Date facultative (en UTC) à laquelle les devoirs de ce cours doivent être envoyés. Ce champ doit être spécifié si dueTime est spécifié.
dueTime

object (TimeOfDay)

Heure facultative (UTC) à laquelle le devoir doit être rendu. Ce champ doit être spécifié si dueDate est spécifié.
scheduledTime

string (Timestamp format)

Code temporel facultatif de la date de publication prévue de ce devoir.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
maxPoints

number

Note maximale pour ce travail de cours. Si la valeur est nulle ou non spécifiée, le devoir est considéré comme non noté. Cette 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 cours est associé au projet de la console du développeur à l'origine de la requête.

Pour en savoir plus, consultez courseWork.create.

Lecture seule.
assigneeMode

enum (AssigneeMode)

Mode de l'affectation du cours. 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 cours. Ce champ n'est défini que si assigneeMode est INDIVIDUAL_STUDENTS. Si assigneeMode est INDIVIDUAL_STUDENTS, seuls les étudiants spécifiés dans ce champ sont affectés au cours.
submissionModificationMode

enum (SubmissionModificationMode)

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

Lecture seule.
topicId

string

Identifiant du sujet auquel ce cours est associé. Doit correspondre à un sujet existant du cours.
gradeCategory

object (GradeCategory)

Catégorie à laquelle la note de ce cours contribue. Ne s'affiche que lorsqu'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 travail de cours. 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)

Informations sur 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 travail de cours avec une valeur workType de MULTIPLE_CHOICE_QUESTION. Il ne doit pas être défini autrement.
gradingPeriodId

string

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

  • Si aucune valeur n'est spécifiée, l'ID de la période de notation est défini en fonction de dueDate (ou de scheduledTime si aucun dueDate n'est défini).
  • Pour indiquer qu'aucun trimestre de notation n'est associé, définissez ce champ sur une chaîne vide ("").
  • Si vous le spécifiez, il doit correspondre à un ID de période de notation existant dans le cours.

CourseWorkState

États possibles des travaux de cours.

Enums
COURSE_WORK_STATE_UNSPECIFIED Aucun état spécifié. Cette valeur n'est jamais renvoyée.
PUBLISHED État d'un travail 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 publié, mais 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'est spécifié. Cette valeur n'est jamais renvoyée.
MODIFIABLE_UNTIL_TURNED_IN Les devoirs peuvent être modifiés avant d'être envoyés.
MODIFIABLE Vous pouvez modifier les envois à 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 des é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ée des devoirs.

delete

 Supprime un devoir.

get

 Renvoie le travail du cours.

getAddOnContext

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

list

 Affiche la liste des travaux de cours que le demandeur est autorisé à consulter.

modifyAssignees

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

patch

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