Création d’un objet educationClass

Espace de noms: microsoft.graph

Importante

Les API sous la /beta version dans Microsoft Graph sont susceptibles de changer. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .

Créez un cours. Cela créera également un groupe universel. 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 les devoirs et la gestion spéciale dans Microsoft Teams lorsque des équipes sont créées à l’aide du groupe. Notez que cette API crée uniquement le groupe universel et ne crée pas d’équipe. Microsoft Teams fournit une interface utilisateur permettant aux enseignants de créer des équipes pour leurs propres classes à l’aide des groupes créés par cette API.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Non prise en charge.
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	EduRoster.ReadWrite.All

Requête HTTP

POST /education/classes

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire.
Content-Type	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’un objet educationClass.

Réponse

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.

Exemple

Demande

Voici un exemple de demande.

HTTP

POST https://graph.microsoft.com/beta/education/classes
Content-type: application/json

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

C#

var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new EducationClass
{
	Description = "Health Level 1",
	ClassCode = "Health 501",
	DisplayName = "Health 1",
	ExternalId = "11019",
	ExternalName = "Health Level 1",
	ExternalSource = EducationExternalSource.Sis,
	MailNickname = "fineartschool.net",
};
var result = await graphClient.Education.Classes.PostAsync(requestBody);

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const educationClass = {
  description: 'Health Level 1',
  classCode: 'Health 501',
  displayName: 'Health 1',
  externalId: '11019',
  externalName: 'Health Level 1',
  externalSource: 'sis',
  mailNickname: 'fineartschool.net'
};

await client.api('/education/classes')
	.version('beta')
	.post(educationClass);

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

EducationClass educationClass = new EducationClass();
educationClass.description = "Health Level 1";
educationClass.classCode = "Health 501";
educationClass.displayName = "Health 1";
educationClass.externalId = "11019";
educationClass.externalName = "Health Level 1";
educationClass.externalSource = EducationExternalSource.SIS;
educationClass.mailNickname = "fineartschool.net";

graphClient.education().classes()
	.buildRequest()
	.post(educationClass);

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)

requestBody := graphmodels.NewEducationClass()
description := "Health Level 1"
requestBody.SetDescription(&description) 
classCode := "Health 501"
requestBody.SetClassCode(&classCode) 
displayName := "Health 1"
requestBody.SetDisplayName(&displayName) 
externalId := "11019"
requestBody.SetExternalId(&externalId) 
externalName := "Health Level 1"
requestBody.SetExternalName(&externalName) 
externalSource := graphmodels.SIS_EDUCATIONEXTERNALSOURCE 
requestBody.SetExternalSource(&externalSource) 
mailNickname := "fineartschool.net"
requestBody.SetMailNickname(&mailNickname) 

result, err := graphClient.Education().Classes().Post(context.Background(), requestBody, nil)

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Education

$params = @{
	Description = "Health Level 1"
	ClassCode = "Health 501"
	DisplayName = "Health 1"
	ExternalId = "11019"
	ExternalName = "Health Level 1"
	ExternalSource = "sis"
	MailNickname = "fineartschool.net"
}

New-MgEducationClass -BodyParameter $params

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);

$requestBody = new EducationClass();
$requestBody->setDescription('Health Level 1');

$requestBody->setClassCode('Health 501');

$requestBody->setDisplayName('Health 1');

$requestBody->setExternalId('11019');

$requestBody->setExternalName('Health Level 1');

$requestBody->setExternalSource(new EducationExternalSource('sis'));

$requestBody->setMailNickname('fineartschool.net');



$requestResult = $graphServiceClient->education()->classes()->post($requestBody);

Importante

Les sdk Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

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