Répertorier les écoles d’un utilisateur educationUser

Espace de noms: microsoft.graph

Récupérez la liste des établissements scolaires d’un utilisateur.

Remarque : si le jeton délégué est utilisé, les membres peuvent voir uniquement les informations concernant leurs propres établissements scolaires. Utilisez la ressource ...v1.0/education/me/schools dans ce cas.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	EduRoster.ReadBasic
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	EduRoster.Read.All, EduRoster.ReadWrite.All

Requête HTTP

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

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets educationSchool dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

HTTP

GET https://graph.microsoft.com/v1.0/education/me/schools

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var result = await graphClient.Education.Me.Schools.GetAsync();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



result, err := graphClient.Education().Me().Schools().Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

EducationSchoolCollectionWithReferencesPage schools = graphClient.education().me().schools()
	.buildRequest()
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let schools = await client.api('/education/me/schools')
	.get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$result = $graphServiceClient->education()->me()->schools()->get();

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Education

Get-MgEducationMeSchool

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’un instance authProvider, consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
  "value": [
    {
      "id": "10001",
      "displayName": "Contoso High School",
      "description": "Public 9-12 high school",
      "status": "active",
      "externalSource": "sis",
      "principalEmail": "amyr@contoso.com",
      "principalName": "Amy Roebuck",
      "externalPrincipalId": "14007",
      "highestGrade": "12",
      "lowestGrade": "9",
      "schoolNumber": "10001",
      "address": {
        "city": "Los Angeles",
        "countryOrRegion": "United States",
        "postalCode": "98055",
        "state": "CA",
        "street": "12345 Main St."
      },
      "createdBy": {
        "user": {
          "displayName": "Susana Rocha",
          "id": "14012",
        }
      },
      "externalId": "10001",
      "phone": "+1 (253) 555-0102",
    }
  ]
}