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é à ce devoir dans Classroom, unique par 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. Le texte doit être une chaîne UTF-8 valide ne contenant pas plus de 30 000 caractères.

materials[]

object (Material)

Ressources supplémentaires

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

state

enum (CourseWorkMaterialState)

État de ce devoir. Si aucun état n'est spécifié, la valeur par défaut est DRAFT.

creationTime

string (Timestamp format)

Code temporel de création de ce contenu 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)

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

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)

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

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 devoir. 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 supports de cours. Ce champ n'est défini que si assigneeMode est INDIVIDUAL_STUDENTS. Si la valeur de 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 support de cours.

Lecture seule.

topicId

string

Identifiant de la section à laquelle ce support de cours est associé. Doit correspondre à un sujet existant dans le 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 d'un support de cours publié. Il s'agit de l'état par défaut.
DRAFT État d'un support de cours qui n'a pas encore été publié. Les supports de cours dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine.
DELETED État d'un support de cours qui a été publié, mais qui est désormais supprimé. Les supports de cours dans cet état ne sont visibles que par les enseignants du cours et les administrateurs du domaine. Les supports de cours dans cet état sont supprimés au bout d'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 la liste des supports de cours que le demandeur est autorisé à consulter.

patch

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