REST Resource: courses.courseWorkMaterials

Ressource : CourseWorkMaterial

Support de cours 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 (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
Champs
courseId

string

Identifiant du cours.

Lecture seule.

id

string

Identifiant de ce support de cours attribué par Classroom, unique par cours.

Lecture seule.

title

string

Titre de ce support de 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 support de cours. Le texte doit être une chaîne UTF-8 valide ne contenant pas plus de 30 000 caractères.

materials[]

object (Material)

Supports supplémentaires.

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

state

enum (CourseWorkMaterialState)

État de ce support 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 support de cours.

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)

Horodatage de la dernière modification apportée à ce support de cours.

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

scheduledTime

string (Timestamp format)

Horodatage facultatif de la publication programmée de ce support de cours.

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

assigneeMode

enum (AssigneeMode)

Mode d'attribution du support de cours. 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 au support de 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 support de cours.

creatorUserId

string

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

Lecture seule.

topicId

string

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

learningGoals[]

object (LearningGoal)

Facultatif.

Références à tous les objectifs d'apprentissage associés à ce support de cours. Un CourseWorkMaterial ne peut pas comporter plus de 10 objectifs d'apprentissage. Ce champ n'est renseigné que si la previewVersion appropriée est définie.

CourseWorkMaterialState

États possibles du support de cours

Enums
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Aucun état spécifié. Cette valeur n'est jamais renvoyée.
PUBLISHED État du support de cours qui a été publié. Il s'agit de l'état par défaut.
DRAFT État d'un support de cours qui n'est pas encore publié. Le support de cours dans cet état n'est visible que par les enseignants du cours et les administrateurs de domaine.
DELETED État du support de cours qui a été publié, mais qui est maintenant supprimé. Le support de cours dans cet état n'est visible que par les enseignants du cours et les administrateurs de domaine. Le support de cours dans cet état est supprimé après un certain temps.

Méthodes

create

Crée un support de cours.

delete

Supprime un support de cours.

get

Renvoie un support de cours.

getAddOnContext

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

list

Renvoie une liste des supports de cours que le demandeur est autorisé à afficher.

patch

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