REST Resource: courses.courseWork

Ressource: CourseWork

Devoirs créés par un enseignant pour les élèves participant au 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.

En lecture seule.

id

string

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

En lecture seule.

title

string

Titre de ce cours. 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 de cours. 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)

Documents supplémentaires.

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

state

enum (CourseWorkState)

État d'avancement de ce cours. 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.

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 : "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 de cours.

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

dueDate

object (Date)

Date facultative, en UTC, à laquelle les devoirs doivent être rendus. Ce champ doit être spécifié si dueTime est spécifié.

dueTime

object (TimeOfDay)

Heure facultative de la journée, en 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 de la publication planifiée de ce cours.

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 devoir. S'il est nul ou non spécifié, ce 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 cet élément de travail du cours est associé au projet de la Developer Console à l'origine de la demande.

Pour en savoir plus, consultez courseWork.create.

En lecture seule.

assigneeMode

enum (AssigneeMode)

Mode "Personne responsable" du devoir. Si aucune valeur n'est spécifiée, la valeur par défaut est ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identifiants des étudiants ayant accès aux documents de travail. 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 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éé le devoir.

En lecture seule.

topicId

string

Identifiant du sujet auquel cette formation est associée. Doit correspondre à un sujet existant du cours.

gradeCategory

object (GradeCategory)

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

En 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 l'attribution. Ce champ n'est renseigné que lorsque workType est défini sur ASSIGNMENT.

En lecture seule.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

Détails des questions à 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 de cours avec un workType défini sur MULTIPLE_CHOICE_QUESTION, et il ne doit pas être défini autrement.

gradingPeriodId

string

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

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

CourseWorkState

États possibles du travail de cours.

Enums
COURSE_WORK_STATE_UNSPECIFIED Aucun État spécifié. Cette valeur n'est jamais renvoyée.
PUBLISHED État des devoirs qui ont été publiés. Il s'agit de l'état par défaut.
DRAFT État des devoirs qui ne sont pas encore publiés. Seuls les enseignants du cours et les administrateurs du domaine peuvent voir ce travail.
DELETED État des devoirs qui ont été publiés, mais qui ont été supprimés Seuls les enseignants du cours et les administrateurs du domaine peuvent voir ce travail. Cet état est supprimé au bout d'un certain temps.

SubmissionModificationMode

Modes de modification possibles des 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 rendus peuvent être modifiés avant de les rendre.
MODIFIABLE Les envois peuvent être modifiés à tout moment.

Assignment

Informations supplémentaires sur les attributions.

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 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 de personne responsable et les options d'un devoir.

patch

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