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