REST Resource: courses

Ressource: Cours

Cours dans Classroom

Représentation JSON
{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}
Champs
id

string

Identifiant de ce cours attribué par Classroom.

Lorsque vous utilisez creating a course, vous pouvez éventuellement définir cet identifiant sur un alias string dans la requête pour créer un alias correspondant. L'id est toujours attribué par Classroom et ne peut pas être modifié une fois le cours créé.

La spécification de ce champ dans un masque de mise à jour de cours entraîne une erreur.

name

string

Nom du cours. Exemple : "Biologie en 10e année". Veuillez saisir un nom. Il doit comporter entre 1 et 750 caractères et être une chaîne UTF-8 valide.

section

string

Section du cours. Exemple : "Période 2". Si ce champ est défini, il doit s'agir d'une chaîne UTF-8 valide ne dépassant pas 2 800 caractères.

descriptionHeading

string

Titre facultatif de la description. Exemple : "Bienvenue en biologie de 10e année." Si ce champ est défini, il doit s'agir d'une chaîne UTF-8 valide ne dépassant pas 3 600 caractères.

description

string

Description facultative. Par exemple : "Nous allons apprendre la structure des êtres vivants à l'aide de manuels, de conférences d'intervenants et de travaux pratiques. Vous allez être ravi !" Si ce champ est défini, il doit s'agir d'une chaîne UTF-8 valide ne dépassant pas 30 000 caractères.

room

string

Emplacement de la chambre (facultatif) Exemple : "301". Si ce champ est défini, il doit s'agir d'une chaîne UTF-8 valide ne dépassant pas 650 caractères.

ownerId

string

Identifiant du propriétaire d'un cours.

Lorsqu'il est spécifié en tant que paramètre d'un create course request, ce champ est obligatoire. L'identifiant peut être l'un des éléments suivants:

  • Identifiant numérique de l'utilisateur
  • l'adresse e-mail de l'utilisateur ;
  • le littéral de chaîne "me", qui indique l'utilisateur à l'origine de la requête

Cette valeur doit être définie dans une requête de création. Les administrateurs peuvent également spécifier ce champ dans un patch course request pour transférer la propriété. Dans d'autres contextes, il est en lecture seule.

creationTime

string (Timestamp format)

Heure de création du cours. La spécification de ce champ dans un masque de mise à jour de cours entraîne une erreur.

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)

Heure de la dernière mise à jour de ce cours. La spécification de ce champ dans un masque de mise à jour de cours entraîne une erreur.

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

enrollmentCode

string

Code d'inscription à utiliser pour rejoindre ce cours. La spécification de ce champ dans un masque de mise à jour de cours entraîne une erreur.

Lecture seule.

courseState

enum (CourseState)

État du cours. Si aucune valeur n'est spécifiée, l'état par défaut est PROVISIONED.

teacherGroupEmail

string

Adresse e-mail d'un groupe Google contenant tous les enseignants du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations.

Lecture seule.

courseGroupEmail

string

Adresse e-mail d'un groupe Google contenant tous les membres du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations.

Lecture seule.

teacherFolder

object (DriveFolder)

Informations sur un dossier Drive partagé avec tous les enseignants du cours.

Ce champ n'est défini que pour les enseignants du cours et les administrateurs de domaine.

Lecture seule.

courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

Ensembles de ressources qui apparaissent sur la page "À propos" de ce cours.

Lecture seule.

guardiansEnabled

boolean

Indique si les notifications destinées aux représentants légaux sont activées pour ce cours.

Lecture seule.

calendarId

string

ID d'un agenda accessible à tous les membres du cours, auquel Classroom ajoute des événements pour les devoirs et les annonces du cours.

Le calendrier d'un cours est créé de manière asynchrone lorsque le cours est défini sur CourseState.ACTIVE pour la première fois (au moment de la création ou lorsqu'il est mis à jour en ACTIVE via l'UI ou l'API). L'ID du calendrier ne sera renseigné qu'une fois le processus de création terminé.

Lecture seule.

gradebookSettings

object (GradebookSettings)

Paramètres du cahier de notes qui spécifient comment la note globale d'un élève pour le cours sera calculée et à qui elle sera affichée.

Lecture seule

CourseState

États possibles d'un cours.

Enums
COURSE_STATE_UNSPECIFIED Aucun état de cours. Aucun message de cours renvoyé n'utilisera cette valeur.
ACTIVE Le cours est actif.
ARCHIVED Le cours a été archivé. Vous ne pouvez pas le modifier, sauf pour changer son état.
PROVISIONED Le cours a été créé, mais n'a pas encore été activé. Il est accessible à l'enseignant principal et aux administrateurs de domaine, qui peuvent le modifier ou le définir sur les états ACTIVE ou DECLINED. Vous ne pouvez définir l'état d'un cours sur PROVISIONED que s'il est à l'état DECLINED.
DECLINED Le cours a été créé, mais refusé. Il est accessible au propriétaire du cours et aux administrateurs du domaine, mais il ne s'affiche pas dans l'UI Web. Vous ne pouvez pas modifier le cours, sauf pour le définir sur l'état PROVISIONED. Vous ne pouvez définir l'état d'un cours sur DECLINED que s'il est à l'état PROVISIONED.
SUSPENDED Le cours a été suspendu. Vous ne pouvez pas modifier le cours, et seul l'utilisateur identifié par le ownerId peut le consulter. Un cours peut être placé dans cet état s'il est susceptible d'enfreindre les conditions d'utilisation.

CourseMaterialSet

Ensemble de documents qui s'affichent sur la page "À propos" du cours. Ces documents peuvent inclure un programme, un calendrier ou d'autres informations générales sur le cours dans son ensemble.

Représentation JSON
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
Champs
title

string

Titre de cet ensemble.

materials[]

object (CourseMaterial)

Supports associés à cet ensemble.

CourseMaterial

Support de cours associé à un cours dans le cadre d'un ensemble de supports.

Représentation JSON
{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}
Champs
Champ d'union material. Données sur les matériaux. material ne peut être qu'un des éléments suivants :
driveFile

object (DriveFile)

Pièce jointe Google Drive

youTubeVideo

object (YouTubeVideo)

Vidéo YouTube jointe.

form

object (Form)

Pièce jointe Google Forms

GradebookSettings

Paramètres du cahier de notes pour un cours. Pour en savoir plus, consultez l'article du centre d'aide.

Représentation JSON
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
Champs
calculationType

enum (CalculationType)

Indique comment la note globale est calculée.

displaySetting

enum (DisplaySetting)

Indique les personnes autorisées à voir la note globale.

gradeCategories[]

object (GradeCategory)

Catégories de notes disponibles pour les travaux et devoirs du cours.

CalculationType

Méthodes possibles de calcul de la note globale.

Enums
CALCULATION_TYPE_UNSPECIFIED Aucune méthode n'est spécifiée. Cette valeur n'est jamais renvoyée.
TOTAL_POINTS La note globale correspond à la somme des notes divisée par le total des points, quelle que soit la catégorie.
WEIGHTED_CATEGORIES La note globale correspond à la moyenne pondérée par catégorie.

DisplaySetting

Paramètres possibles pour afficher la note globale.

Enums
DISPLAY_SETTING_UNSPECIFIED Aucun paramètre n'est spécifié. Cette valeur n'est jamais renvoyée.
SHOW_OVERALL_GRADE Affiche la note globale dans le carnet de notes et le profil de l'élève, pour les enseignants et les élèves.
HIDE_OVERALL_GRADE La note globale ne s'affiche pas dans le carnet de notes ni dans le profil de l'élève.
SHOW_TEACHERS_ONLY Affiche la note globale aux enseignants dans le carnet de notes et le profil de l'élève. Il est masqué dans le profil de l'élève.

Méthodes

checkAddOnCreationEligibility
(deprecated)

Indique si un utilisateur est autorisé à créer des pièces jointes de modules complémentaires dans un cours donné.

checkGradingPeriodsSetupEligibility
(deprecated)

Indique si un utilisateur est autorisé à modifier les paramètres de période de notation dans un cours donné.

create

Crée un cours.

delete

Supprime un cours.

get

Renvoie un cours.

getGradingPeriodSettings

Renvoie les paramètres de la période de notation d'un cours.

list

Affiche la liste des cours que l'utilisateur à l'origine de la requête est autorisé à consulter, en les limitant à ceux qui correspondent à la requête.

patch

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

update

Met à jour un cours.

updateGradingPeriodSettings

Met à jour les paramètres de période de notation d'un cours.