Enumeración de taughtClasses

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga los recursos educationClass propiedad de educationUser.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) EduRoster.ReadBasic No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación EduRoster.Read.All EduRoster.ReadWrite.All

Nota:

Tenga en cuenta que si se usa el token delegado, los usuarios solo pueden ver información sobre sus propias clases.

Solicitud HTTP

GET /education/me/taughtClasses
GET /education/users/{educationUserId}/taughtClasses

Parámetros de consulta opcionales

Puede usar la opción de consulta de OData $orderby para ordenar grupos de una organización por el valor displayName, tal y como se muestra en el ejemplo siguiente:

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

También puede usar los $filterparámetros y $search$count de consulta para limitar la respuesta.

Cuando se agregan o actualizan elementos para este recurso, se indexan específicamente para usarse con los parámetros de consulta $count y $search. Puede producirse un leve retraso entre el momento en que se agrega o se actualiza un elemento y el momento en que está disponible en el índice.

Para más información sobre las opciones de consulta de OData, consulte Parámetros de consulta de OData.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y una colección de objetos educationClass en el cuerpo de la respuesta.

Ejemplos

Solicitud

GET https://graph.microsoft.com/v1.0/education/users/{educationUserId}/taughtClasses

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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