Répertorier des classesList classes

Espace de noms: microsoft.graphNamespace: microsoft.graph

Récupérez la liste des objets de cours.Retrieve a list of class objects. Notez que, si le jeton délégué est utilisé, les membres peuvent voir uniquement les informations concernant leurs propres cours.Note that if the delegated token is used, members can only see information about their own classes.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) EduRoster.ReadBasicEduRoster.ReadBasic
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication EduRoster.Read.All, EduRoster.ReadWrite.AllEduRoster.Read.All, EduRoster.ReadWrite.All

Requête HTTPHTTP request

GET /education/me/classes
GET /education/users/{id}/classes

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData Query Parameters to help customize the response.

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets educationClass dans le corps de la réponse.If successful, this method returns a 200 OK response code and a collection of educationClass objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/education/me/classes
RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 277

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