创建 educationClass

命名空间：microsoft.graph

创建新的 educationClass 对象。

备注

此操作还会创建通用组。 使用此 API 创建课程时，它会向组添加特殊属性，这将在使用组创建团队时在 Microsoft Teams 中添加分配和特殊处理等功能。 请注意，此 API 仅创建通用组，不会创建团队。 Microsoft Teams为教师提供用户界面，以使用此 API 创建的组创建自己的班级团队。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	不支持。
委派（个人 Microsoft 帐户）	不支持。
应用程序	EduRoster.ReadWrite.All

HTTP 请求

POST /education/classes

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-Type	application/json. Required.

请求正文

在请求正文中，提供 educationClass 对象的 JSON 表示形式。

下表显示创建 educationClass时所需的属性。

属性	类型	说明
id	String	对象标识符。 继承自 实体
displayName	String	课程名称。
mailNickname	String	向所有成员发送电子邮件的邮件名称（如果已启用）。
说明	String	课程说明。
createdBy	identitySet	创建了课程的实体
classCode	String	学校用于标识课程的课程代码。
externalName	String	同步系统中的课程名称。
externalId	String	来自同步系统的课程 ID。
externalSource	educationExternalSource	此课程的创建方式。 可能的值包括： sis 、 manual
externalSourceDetail	String	生成此资源的外部源的名称。
grade	String	课程的年级。
term	educationTerm	此课程的学期。

响应

如果成功，此方法会在响应正文中返回 201 Created 响应代码和 educationClass 对象。

示例

请求

HTTP

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

{
  "@odata.type": "#microsoft.graph.educationClass",
  "displayName": "String",
  "mailNickname": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"
  }
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var educationClass = new EducationClass
{
    DisplayName = "String",
    MailNickname = "String",
    Description = "String",
    CreatedBy = new IdentitySet
    {
    },
    ClassCode = "String",
    ExternalName = "String",
    ExternalId = "String",
    ExternalSource = EducationExternalSource.Sis,
    ExternalSourceDetail = "String",
    Grade = "String",
    Term = new EducationTerm
    {
    }
};

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

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const educationClass = {
  '@odata.type': '#microsoft.graph.educationClass',
  displayName: 'String',
  mailNickname: 'String',
  description: 'String',
  createdBy: {
    '@odata.type': 'microsoft.graph.identitySet'
  },
  classCode: 'String',
  externalName: 'String',
  externalId: 'String',
  externalSource: 'String',
  externalSourceDetail: 'String',
  grade: 'String',
  term: {
    '@odata.type': 'microsoft.graph.educationTerm'
  }
};

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

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
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 setDisplayName:@"String"];
[educationClass setMailNickname:@"String"];
[educationClass setDescription:@"String"];
MSGraphIdentitySet *createdBy = [[MSGraphIdentitySet alloc] init];
[educationClass setCreatedBy:createdBy];
[educationClass setClassCode:@"String"];
[educationClass setExternalName:@"String"];
[educationClass setExternalId:@"String"];
[educationClass setExternalSource: [MSGraphEducationExternalSource sis]];
[educationClass setExternalSourceDetail:@"String"];
[educationClass setGrade:@"String"];
MSGraphEducationTerm *term = [[MSGraphEducationTerm alloc] init];
[educationClass setTerm:term];

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

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Java

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

EducationClass educationClass = new EducationClass();
educationClass.displayName = "String";
educationClass.mailNickname = "String";
educationClass.description = "String";
IdentitySet createdBy = new IdentitySet();
educationClass.createdBy = createdBy;
educationClass.classCode = "String";
educationClass.externalName = "String";
educationClass.externalId = "String";
educationClass.externalSource = EducationExternalSource.SIS;
educationClass.externalSourceDetail = "String";
educationClass.grade = "String";
EducationTerm term = new EducationTerm();
educationClass.term = term;

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

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Go

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

requestBody := msgraphsdk.NewEducationClass()
displayName := "String"
requestBody.SetDisplayName(&displayName)
mailNickname := "String"
requestBody.SetMailNickname(&mailNickname)
description := "String"
requestBody.SetDescription(&description)
createdBy := msgraphsdk.NewIdentitySet()
requestBody.SetCreatedBy(createdBy)
createdBy.SetAdditionalData(map[string]interface{}{
    "@odata.type": "microsoft.graph.identitySet",
}
classCode := "String"
requestBody.SetClassCode(&classCode)
externalName := "String"
requestBody.SetExternalName(&externalName)
externalId := "String"
requestBody.SetExternalId(&externalId)
externalSource := "String"
requestBody.SetExternalSource(&externalSource)
externalSourceDetail := "String"
requestBody.SetExternalSourceDetail(&externalSourceDetail)
grade := "String"
requestBody.SetGrade(&grade)
term := msgraphsdk.NewEducationTerm()
requestBody.SetTerm(term)
term.SetAdditionalData(map[string]interface{}{
    "@odata.type": "microsoft.graph.educationTerm",
}
requestBody.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.educationClass",
}
result, err := graphClient.Education().Classes().Post(requestBody)

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

PowerShell

Import-Module Microsoft.Graph.Education

$params = @{
    "@odata.type" = "#microsoft.graph.educationClass"
    DisplayName = "String"
    MailNickname = "String"
    Description = "String"
    CreatedBy = @{
        "@odata.type" = "microsoft.graph.identitySet"
    }
    ClassCode = "String"
    ExternalName = "String"
    ExternalId = "String"
    ExternalSource = "String"
    ExternalSourceDetail = "String"
    Grade = "String"
    Term = @{
        "@odata.type" = "microsoft.graph.educationTerm"
    }
}

New-MgEducationClass -BodyParameter $params

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

响应

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "@odata.type": "#microsoft.graph.educationClass",
  "id": "64ef8ce5-8ce5-64ef-e58c-ef64e58cef64",
  "displayName": "String",
  "mailNickname": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"
  }
}