Création d’un objet educationClassCreate educationClass

Espace de noms: microsoft.graphNamespace: microsoft.graph

Créez un cours.Create a new class. Cela créera également un groupe universel.This will also create a universal group. Lorsque vous utilisez cette API pour créer une classe, elle ajoute des propriétés spéciales au groupe, ce qui ajoute des fonctionnalités telles que des affectations et une gestion spéciale au sein de Microsoft teams lorsque les équipes sont créées à l’aide du groupe.When you use this API to create a class, it will add special properties to the group, which will add features such as assignments and special handling within Microsoft Teams when teams are created using the group. Veuillez noter que cette API crée uniquement le groupe universel et ne crée pas d’équipe.Please note that this API only creates the universal group and does not create a team. Microsoft teams fournit une interface utilisateur pour les enseignants afin de créer des équipes pour leurs propres classes à l’aide des groupes créés par cette API.Microsoft Teams provides a user interface for teachers to create teams for their own classes using the groups created by this API.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Non prise en charge.Not supported.
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication EduRoster.ReadWrite.AllEduRoster.ReadWrite.All

Requête HTTPHTTP request

POST /education/classes

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON d’un objet educationClass.In the request body, supply a JSON representation of an educationClass object.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 201 Created et un objet educationClass dans le corps de la réponse.If successful, this method returns a 201 Created response code and an educationClass object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

POST https://graph.microsoft.com/v1.0/education/classes
Content-type: application/json
Content-length: 224

{
  "description": "Health Level 1",
  "classCode": "Health 501",
  "displayName": "Health 1",
  "externalId": "11019",
  "externalName": "Health Level 1",
  "externalSource": "sis",
  "mailNickname": "fineartschool.net"
}
RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 224

{
    "id": "11019",
    "description": "Health Level 1",
    "classCode": "Health 501",
    "createdBy": {
      "user": {
        "displayName": "Susana Rocha",
        "id": "14012",
      }
    },
    "displayName": "Health 1",
    "externalId": "11019",
    "externalName": "Health Level 1",
    "externalSource": "sis",
    "mailNickname": "fineartschool.net"
}