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