Create educationClassCreate educationClass

名前空間: microsoft.graphNamespace: microsoft.graph

新しいクラスを作成します。Create a new class. これはユニバーサル グループも作成します。This will also create a universal group. この API を使用してクラスを作成すると、グループに特別なプロパティが追加されます。これにより、グループを使用して teams を作成するときに、Microsoft Teams 内での割り当てや特別な処理などの機能が追加されます。When you use this API to create a class, it will add special properties to the group, which will add features such as assignments and special handling within Microsoft Teams when teams are created using the group. この API は、ユニバーサルグループのみを作成し、チームを作成しないことに注意してください。Please note that this API only creates the universal group and does not create a team. Microsoft Teams では、この API によって作成されたグループを使用して、自分のクラスのチームを作成するためのユーザーインターフェイスが教師に提供されます。Microsoft Teams provides a user interface for teachers to create teams for their own classes using the groups created by this API.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) サポートされていません。Not supported.
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication EduRoster.ReadWrite.AllEduRoster.ReadWrite.All

HTTP 要求HTTP request

POST /education/classes

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

要求本文Request body

要求本文で、educationClass オブジェクトの JSON 表記を指定します。In the request body, supply a JSON representation of an educationClass object.

応答Response

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で educationClass オブジェクトを返します。If successful, this method returns a 201 Created response code and an educationClass object in the response body.

Example

要求Request

要求の例を次に示します。The following is an example of the request.

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

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

応答の例を次に示します。The following is an example of the response.

注: 読みやすくするために、ここに示す応答オブジェクトは短くされている場合があります。実際の呼び出しからは、すべてのプロパティが返されます。Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

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