Mitglieder einer educationClass auflisten
Namespace: microsoft.graph
Ruft die educationUser-Member einer educationClass ab.
Berechtigungen
Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | EduRoster.ReadBasic |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | EduRoster.Read.All, EduRoster.ReadWrite.All plus Member.Read.Hidden |
Hinweis
Hinweis: Wenn das delegierte Token verwendet wird, erhalten Mitglieder nur Informationen zu ihren eigenen Klassen.
HTTP-Anforderung
GET /education/classes/{id}/members
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort, einschließlich $search
, $count
und $filter
.
Wenn Elemente für diese Ressource hinzugefügt oder aktualisiert werden, werden sie speziell für die Verwendung mit den $count
und $search
Abfrageparametern indexiert. Es kann zu einer geringfügigen Verzögerung zwischen dem Hinzufügen oder Aktualisieren eines Elements und der Verfügbarkeit im Index kommen.
Weitere Informationen zu OData-Abfrageoptionen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. |
Anforderungstext
Geben Sie für diese Methode keinen Anforderungstext an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und eine Sammlung von educationUser-Objekten im Antworttext zurückgegeben.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
GET https://graph.microsoft.com/v1.0/education/classes/7e4ec76c-8276-43ef-ba10-9aaa197cb212/members
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.educationUser)",
"value": [
{
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"accountEnabled": true,
"displayName": "Adele Vance",
"givenName": "Adele",
"surname": "Vance",
"userPrincipalName": "AdeleV@M365x214355.onmicrosoft.com",
"userType": "Member",
"primaryRole": "teacher",
"onPremisesInfo": {
"immutableId": null
},
"teacher": {}
},
{
"id": "b66ecf79-a093-4d51-86e0-efcc4531f37a",
"accountEnabled": true,
"displayName": "Christie Cline",
"givenName": "Christie",
"surname": "Cline",
"userPrincipalName": "ChristieC@M365x214355.onmicrosoft.com",
"userType": "Member",
"primaryRole": "student",
"onPremisesInfo": {
"immutableId": null
},
"student": {}
},
{
"id": "f5289423-7233-4d60-831a-fe107a8551cc",
"accountEnabled": true,
"displayName": "Ben Walters",
"givenName": "Ben",
"surname": "Walters",
"userPrincipalName": "BenW@M365x214355.onmicrosoft.com",
"userType": "Member",
"primaryRole": "student",
"onPremisesInfo": {
"immutableId": null
},
"student": {}
},
{
"id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
"accountEnabled": true,
"displayName": "Megan Bowen",
"givenName": "Megan",
"surname": "Bowen",
"userPrincipalName": "MeganB@M365x214355.onmicrosoft.com",
"userType": "Member",
"primaryRole": "teacher",
"onPremisesInfo": {
"immutableId": null
},
"teacher": {}
},
{
"id": "c03e6eaa-b6ab-46d7-905b-73ec7ea1f755",
"accountEnabled": true,
"displayName": "Allan Deyoung",
"givenName": "Allan",
"surname": "Deyoung",
"userPrincipalName": "AllanD@M365x214355.onmicrosoft.com",
"userType": "Member",
"primaryRole": "student",
"onPremisesInfo": {
"immutableId": null
},
"student": {}
}
]
}