Create educationClass

[アーティクル]
01/21/2022

名前空間: microsoft.graph

注意

これはユニバーサルグループも作成します。この API を使用してクラスを作成すると、グループに特別なプロパティが追加され、グループを使用してチームが作成されると、Microsoft Teams 内で割り当てや特別な処理などの機能が追加されます。この API はユニバーサルグループのみを作成し、チームを作成しない点に注意してください。 Microsoft Teams API によって作成されたグループを使用して、教師が独自のクラスのチームを作成するユーザーインターフェイスを提供します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	EduRoster.ReadWrite.All

HTTP 要求

POST /education/classes

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。
Content-Type	application/json. Required.

要求本文

要求本文で、educationClass オブジェクトの JSON 表記を指定します。

次の表に、educationClass を作成するときに必要なプロパティを示します。

プロパティ	型	説明
id	文字列	オブジェクト識別子。エンティティから継承
displayName	String	クラスの名前。
mailNickname	文字列	すべてのメンバーに電子メールを送信する際のメール名 (この機能が有効な場合)。
description	String	クラスの説明。
createdBy	identitySet	クラスを作成したエンティティ。
classCode	String	クラスを識別するために学校が使用するクラスコード。
externalName	String	同期システムからのクラスの名前。
externalId	String	同期システムからのクラスの ID。
externalSource	educationExternalSource	このクラスの作成方法。指定できる値は次のとおりです。 sis``manual
externalSourceDetail	String	このリソースが生成された外部ソースの名前。
grade	String	クラスの成績レベル。
term	educationTerm	このクラスの学期。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で educationClass オブジェクトを返します。

例

要求

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


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 のドキュメントを参照してください。


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 のドキュメントを参照してください。


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 のドキュメントを参照してください。


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 のドキュメントを参照してください。


//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 のドキュメントを参照してください。


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

Create educationClass

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック