Création d’un objet educationClass

Cette page est-elle utile ?

D'autres commentaires ?

Les commentaires seront envoyés à Microsoft : en appuyant sur le bouton envoyer, vos commentaires seront utilisés pour améliorer les produits et services Microsoft. Politique de confidentialité.

Espace de noms: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. 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 des affectations et une gestion spéciale au sein de 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 nécessaire 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#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var educationClass = new EducationClass
{
    Description = "Health Level 1",
    ClassCode = "Health 501",
    DisplayName = "Health 1",
    ExternalId = "11019",
    ExternalName = "Health Level 1",
    ExternalSource = EducationExternalSource.Sis,
    MailNickname = "fineartschool.net"
};

await graphClient.Education.Classes
    .Request()
    .AddAsync(educationClass);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

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);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/education/classes"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphEducationClass *educationClass = [[MSGraphEducationClass alloc] init];
[educationClass setDescription:@"Health Level 1"];
[educationClass setClassCode:@"Health 501"];
[educationClass setDisplayName:@"Health 1"];
[educationClass setExternalId:@"11019"];
[educationClass setExternalName:@"Health Level 1"];
[educationClass setExternalSource: [MSGraphEducationExternalSource sis]];
[educationClass setMailNickname:@"fineartschool.net"];

NSError *error;
NSData *educationClassData = [educationClass getSerializedDataWithError:&error];
[urlRequest setHTTPBody:educationClassData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

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);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.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 := "sis"
requestBody.SetExternalSource(&externalSource)
mailNickname := "fineartschool.net"
requestBody.SetMailNickname(&mailNickname)
result, err := graphClient.Education().Classes().Post(requestBody)

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

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

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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 SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

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