REST Resource: courses.courseWorkMaterials

Ressource: CourseWorkMaterial

Supports de cours 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 (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": 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 matériel de travail Le texte doit être une chaîne UTF-8 valide ne contenant pas plus de 30 000 caractères.

materials[]

object (Material)

Autres ressources

Le matériel d'un cours ne doit pas comporter plus de 20 éléments.

state

enum (CourseWorkMaterialState)

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

creationTime

string (Timestamp format)

Code temporel de création de ce matériel 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 document de travail du 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".

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

assigneeMode

enum (AssigneeMode)

Mode de l'auteur du devoir 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 contenu du cours. Ce champ n'est défini que si assigneeMode est INDIVIDUAL_STUDENTS. Si assigneeMode est INDIVIDUAL_STUDENTS, seuls les élèves spécifiés dans ce champ peuvent voir le contenu du cours.

creatorUserId

string

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

Lecture seule.

topicId

string

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

CourseWorkMaterialState

États possibles des supports de cours

Enums
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Aucun état spécifié. Cette valeur n'est jamais renvoyée.
PUBLISHED État du devoir publié. Il s'agit de l'état par défaut.
DRAFT État d'un devoir qui n'a pas encore été publié. Les devoirs dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine.
DELETED État du devoir 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 devoirs dans cet état sont supprimés au bout d'un certain temps.

Méthodes

create

Crée un devoir.

delete

Supprime un matériel de cours.

get

Renvoie un matériel de 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 supports de cours que le demandeur est autorisé à consulter.

patch

Met à jour un ou plusieurs champs d'un matériel de cours.