名前空間: microsoft.graph
新しい educationClass オブジェクトを作成します。
注:
これはユニバーサル グループも作成します。 この API を使用してクラスを作成すると、グループに特別なプロパティが追加されます。これにより、グループを使用してチームが作成されるときに、Microsoft Teams 内で割り当てや特別な処理などの機能が追加されます。 この API はユニバーサル グループのみを作成し、チームを作成しないことに注意してください。 Microsoft Teams には、この API によって作成されたグループを使用して、教師が独自のクラス用のチームを作成するためのユーザー インターフェイスが用意されています。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
✅ |
❌ |
❌ |
❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 |
最小特権アクセス許可 |
特権の高いアクセス許可 |
委任 (職場または学校のアカウント) |
サポートされていません。 |
サポートされていません。 |
委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
アプリケーション |
EduRoster.ReadWrite.All |
注意事項なし。 |
HTTP 要求
POST /education/classes
名前 |
説明 |
Authorization |
ベアラー {token}。 必須です。
認証と承認の詳細については、こちらをご覧ください。 |
Content-Type |
application/json. 必須です。 |
要求本文
要求本文で、 educationClass オブジェクトの JSON 表現を指定します。
次の表に、 educationClass を作成するときに必要なプロパティを示します。
プロパティ |
型 |
説明 |
id |
String |
オブジェクト識別子。
エンティティから継承 |
displayName |
String |
クラスの名前。 |
mailNickname |
String |
すべてのメンバーに電子メールを送信する際のメール名 (この機能が有効な場合)。 |
説明 |
String |
クラスの説明。 |
createdBy |
identitySet |
クラスを作成したエンティティ。 |
classCode |
String |
クラスを識別するために学校が使用するクラス コード。 |
externalName |
String |
同期システムからのクラスの名前。 |
外部ID |
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"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EducationClass
{
OdataType = "#microsoft.graph.educationClass",
DisplayName = "String",
MailNickname = "String",
Description = "String",
CreatedBy = new IdentitySet
{
OdataType = "microsoft.graph.identitySet",
},
ClassCode = "String",
ExternalName = "String",
ExternalId = "String",
ExternalSource = EducationExternalSource.Sis,
ExternalSourceDetail = "String",
Grade = "String",
Term = new EducationTerm
{
OdataType = "microsoft.graph.educationTerm",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Education.Classes.PostAsync(requestBody);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
mgc education classes create --body '{\
"@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"\
}\
}\
'
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewEducationClass()
displayName := "String"
requestBody.SetDisplayName(&displayName)
mailNickname := "String"
requestBody.SetMailNickname(&mailNickname)
description := "String"
requestBody.SetDescription(&description)
createdBy := graphmodels.NewIdentitySet()
requestBody.SetCreatedBy(createdBy)
classCode := "String"
requestBody.SetClassCode(&classCode)
externalName := "String"
requestBody.SetExternalName(&externalName)
externalId := "String"
requestBody.SetExternalId(&externalId)
externalSource := graphmodels.STRING_EDUCATIONEXTERNALSOURCE
requestBody.SetExternalSource(&externalSource)
externalSourceDetail := "String"
requestBody.SetExternalSourceDetail(&externalSourceDetail)
grade := "String"
requestBody.SetGrade(&grade)
term := graphmodels.NewEducationTerm()
requestBody.SetTerm(term)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
classes, err := graphClient.Education().Classes().Post(context.Background(), requestBody, nil)
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EducationClass educationClass = new EducationClass();
educationClass.setOdataType("#microsoft.graph.educationClass");
educationClass.setDisplayName("String");
educationClass.setMailNickname("String");
educationClass.setDescription("String");
IdentitySet createdBy = new IdentitySet();
createdBy.setOdataType("microsoft.graph.identitySet");
educationClass.setCreatedBy(createdBy);
educationClass.setClassCode("String");
educationClass.setExternalName("String");
educationClass.setExternalId("String");
educationClass.setExternalSource(EducationExternalSource.Sis);
educationClass.setExternalSourceDetail("String");
educationClass.setGrade("String");
EducationTerm term = new EducationTerm();
term.setOdataType("microsoft.graph.educationTerm");
educationClass.setTerm(term);
EducationClass result = graphClient.education().classes().post(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 のドキュメントを参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EducationClass;
use Microsoft\Graph\Generated\Models\IdentitySet;
use Microsoft\Graph\Generated\Models\EducationExternalSource;
use Microsoft\Graph\Generated\Models\EducationTerm;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EducationClass();
$requestBody->setOdataType('#microsoft.graph.educationClass');
$requestBody->setDisplayName('String');
$requestBody->setMailNickname('String');
$requestBody->setDescription('String');
$createdBy = new IdentitySet();
$createdBy->setOdataType('microsoft.graph.identitySet');
$requestBody->setCreatedBy($createdBy);
$requestBody->setClassCode('String');
$requestBody->setExternalName('String');
$requestBody->setExternalId('String');
$requestBody->setExternalSource(new EducationExternalSource('string'));
$requestBody->setExternalSourceDetail('String');
$requestBody->setGrade('String');
$term = new EducationTerm();
$term->setOdataType('microsoft.graph.educationTerm');
$requestBody->setTerm($term);
$result = $graphServiceClient->education()->classes()->post($requestBody)->wait();
プロジェクトに 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 のドキュメントを参照してください。
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.education_class import EducationClass
from msgraph.generated.models.identity_set import IdentitySet
from msgraph.generated.models.education_external_source import EducationExternalSource
from msgraph.generated.models.education_term import EducationTerm
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = EducationClass(
odata_type = "#microsoft.graph.educationClass",
display_name = "String",
mail_nickname = "String",
description = "String",
created_by = IdentitySet(
odata_type = "microsoft.graph.identitySet",
),
class_code = "String",
external_name = "String",
external_id = "String",
external_source = EducationExternalSource.Sis,
external_source_detail = "String",
grade = "String",
term = EducationTerm(
odata_type = "microsoft.graph.educationTerm",
),
)
result = await graph_client.education.classes.post(request_body)
プロジェクトに 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"
}
}