列出 educationClasses

命名空间:microsoft.graph

获取 educationClass 对象及其属性的列表。

权限

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

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

HTTP 请求

GET /education/classes

可选的查询参数

可以使用 OData 查询选项 $orderby,按 displayName 值对组织中的组进行排序,如下面的示例所示:

GET https://graph.microsoft.com/v1.0/groups?$orderby=displayName

还可以使用 $filter$count$search 查询参数来限制响应。

为该资源添加或更新项目时,将对它们进行专门索引,以便与 $count$search 查询参数一起使用。 在添加或更新项目与在索引中可用之间可能会稍有延迟。

有关 OData 查询选项的详细信息,请参阅 OData 查询参数

请求标头

名称 说明
Authorization 持有者 {token}。 必填。

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法会在响应正文中返回 200 OK 响应代码和 educationClass 对象的集合。

示例

请求

GET https://graph.microsoft.com/v1.0/education/classes

响应

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@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"
      }
    }
  ]
}