Rufen Sie über die Learn365-API eine Liste der Delegierten und ihrer Teammitglieder ab

Delegierte sind Benutzer, die andere Benutzer verwalten, ohne dabei die aktuelle Organisationshierarchie zu durchbrechen oder zu ändern. Jeder Learn365-Benutzer, einschließlich Linienmanagern und Proxy-Managern, kann ein Delegierter sein, der jeden Benutzer in der Organisation verwalten kann.

Weitere Informationen zu Delegierten finden Sie in diesem Artikel.

Es gibt zwei Möglichkeiten, Delegierte und ihre Teammitglieder in der Learn365-API anzuzeigen:

• Rufen Sie eine Liste aller Delegierten und ihrer Teammitglieder ab.
• Rufen Sie eine Liste der Teammitglieder für einen bestimmten Delegierten ab.

Rufen Sie eine Liste der Delegierten und ihrer Teammitglieder ab

GET /services/users/v2/Delegates

Mit der Anfrage können Sie eine Liste der Delegierten und ihrer Teammitglieder in Ihrer Organisation abrufen.

Voraussetzungen

Um die Anfrage zu senden, benötigen Sie einen API-Schlüssel.

Abfrageparameter

Verwenden Sie Abfrageoptionsparameter, um die Daten in der Antwort zu steuern.

Anfragebeispiel

GET /services/users/v2/Delegates

Parameter des Antworttexts

Die erfolgreiche 200-Antwort enthält ein Array aller Delegierten und ihrer Teammitglieder in Ihrer Organisation. In diesem Array ist jedes Element eine separate Zuordnung zwischen Delegiertem und Teammitglied. Wenn ein Delegierter mehrere Teammitglieder verwaltet, wird jede Zuordnung separat aufgeführt. 

Jedes Element im Array hat die folgenden Parameter:

• delegateId (string). Die Benutzer-ID eines Delegierten.
• teamMemberId (string). Die Benutzer-ID eines Teammitglieds.
• isDeleted (boolean). Gibt an, ob die Delegierten-Zuweisung gelöscht (true) wurde oder nicht (false).
• delegate (Objekt) und teamMember (Objekt). Jedes dieser Objekte enthält die folgenden Details zu einem Delegierten bzw. dessen Teammitglied:
  • id (String). Die Benutzer-ID.
  • title (String). Der vollständige Name des Benutzers.
  • email (String). Die E-Mail-Adresse des Benutzers.
  • managerId (String). Die ID des Managers.
  • isDisabled (Boolean). Gibt an, ob der Benutzer aktiv (false) ist oder nicht (true).
  • isDeleted (boolean). Gibt an, ob das Benutzerkonto gelöscht (true) wurde oder nicht (false).
  • createdAt (String). Datum und Uhrzeit der Erstellung des Benutzerkontos.
  • modifiedAt (String). Datum und Uhrzeit der letzten Änderung des Benutzerkontos.
  • profile (Objekt). Das Objekt enthält grundlegende Benutzerdetails: Abteilung, Stadt, Land, Büro usw.
  • externalReferences (Array). Das Array enthält die Quelle des Benutzerkontos (z. B. bedeutet AzureAD das Microsoft Entra-Benutzerkonto) sowie die zu dieser Quelle gehörenden Details: ID, Name und Metadaten.
  • identity (String). Die Identität des Benutzers.

Antwortbeispiel

Die erfolgreiche 200-Antwort gibt einen ähnlichen Textkörper zurück:

[
 {
   "delegateId": "c34b3379-3170-4462-607b-08de263288eb",
   "teamMemberId": "9e995999-31ee-4476-b15e-35309f369597",
   "isDeleted": false,
   "delegate": {
     "id": "c34b3379-3170-4462-607b-08de263288eb",
     "Titel": "Tyler Dunn",
     "email": null,
     "managerId": "7853ce01-9a6f-4e07-a3e0-1e3a578655d7",
     "isDisabled": false,
     "isDeleted": false,
     "createdAt": "2025-11-18T08:38:42.94",
     "modifiedAt": "2025-11-18T08:38:42.94",
     "profile": {
       "userId": "c34b3379-3170-4462-607b-08de263288eb",
       "department": null,
       "city": null,
       "country": null,
       "office": null,
       "jobTitle": null,
       "company": null,
       "phone": null,
       "firstName": "Tyler",
       "lastName": "Dunn",
       "hireDateTime": null,
       "createdAt": "2025-11-18T08:38:42.94",
       "modifiedAt": "2025-11-18T08:38:42.94"
     },
     "externalReferences": [
       {
         "userSource": "AzureAD",
         "externalId": "2a5d724b-d11c-494f-9361-8fce5e3b48cb",
         "externalName": "tdunn@compafi464.onmicrosoft.com",
         "metadata": "{\"PrincipalClaimPrefixType\":0}"
       }
     ],
     "identity": null
   },
   "teamMember": {
     "id": "9e995999-31ee-4476-b15e-35309f369597",
     "Titel": "Robert Smith",
     "email": "rsmith@compafi464.onmicrosoft.com",
     "managerId": "4cf1a461-a435-4e80-8ac6-a2d4f0a7ef71",
     "isDisabled": false,
     "isDeleted": false,
     "createdAt": "2023-11-06T16:23:29.373",
     "modifiedAt": "2025-11-20T01:00:11.897",
     "profile": {
       "userId": "9e995999-31ee-4476-b15e-35309f369597",
       "department": "Talent Management and Development",
       "city": "Chicago",
       "country": "Vereinigte Staaten",
       "office": "Chicago",
       "jobTitle": "LMS-Administrator",
       "company": null,
       "phone": null,
       "firstName": "Robert",
       "lastName": "Smith",
       "hireDateTime": null,
       "createdAt": "1900-01-01T00:00:00",
       "modifiedAt": "2025-10-30T13:32:04.6"
     },
     "externalReferences": [
       {
         "userSource": "AzureAD",
         "externalId": "1bd885a5-60cb-4756-a50b-1e2af04d98ca",
         "externalName": "rsmith@compafi464.onmicrosoft.com",
         "metadata": "{\"PrincipalClaimPrefixType\":0}"
       }
     ],
     "identity": null
   }
 }
]

Rufen Sie eine Liste der Teammitglieder für einen bestimmten Delegierten ab

GET /services/users/v2/Delegates/{delegateId}/members

Mit der Anfrage können Sie eine Liste der Teammitglieder für einen bestimmten Delegierten abrufen.

Voraussetzungen

Um die Anfrage zu senden, benötigen Sie einen API-Schlüssel.

Um eine Liste der Teammitglieder eines bestimmten Delegierten anzuzeigen, benötigen Sie die Benutzer-ID dieses Delegierten. So finden Sie sie: 

1. Senden Sie die Anfrage GET /services/users/v2/Delegates.

2. Suchen Sie in der Antwort die delegateId des gewünschten Delegierten.

Pfadparameter

• delegateId (String). Die Benutzer-ID eines Delegierten.

Anfragebeispiel

GET /services/users/v2/Delegates/c34b3379-3170-4462-607b-08de263288eb/members

Parameter des Antworttexts

Die erfolgreiche 200-Antwort enthält dieselben Parameter wie die Antwort auf die Anfrage GET /services/users/v2/Delegates.

Antwortbeispiel

[
 {
   "delegateId": "c34b3379-3170-4462-607b-08de263288eb",
   "teamMemberId": "9e995999-31ee-4476-b15e-35309f369597",
   "isDeleted": false,
   "delegate": {
     "id": "c34b3379-3170-4462-607b-08de263288eb",
     "Titel": "Tyler Dunn",
     "email": null,
     "managerId": "7853ce01-9a6f-4e07-a3e0-1e3a578655d7",
     "isDisabled": false,
     "isDeleted": false,
     "createdAt": "2025-11-18T08:38:42.94",
     "modifiedAt": "2025-11-18T08:38:42.94",
     "profile": {
       "userId": "c34b3379-3170-4462-607b-08de263288eb",
       "department": null,
       "city": null,
       "country": null,
       "office": null,
       "jobTitle": null,
       "company": null,
       "phone": null,
       "firstName": "Tyler",
       "lastName": "Dunn",
       "hireDateTime": null,
       "createdAt": "2025-11-18T08:38:42.94",
       "modifiedAt": "2025-11-18T08:38:42.94"
     },
     "externalReferences": [
       {
         "userSource": "AzureAD",
         "externalId": "2a5d724b-d11c-494f-9361-8fce5e3b48cb",
         "externalName": "tdunn@compafi464.onmicrosoft.com",
         "metadata": "{\"PrincipalClaimPrefixType\":0}"
       }
     ],
     "identity": null
   },
   "teamMember": {
     "id": "9e995999-31ee-4476-b15e-35309f369597",
     "Titel": "Robert Smith",
     "email": "rsmith@compafi464.onmicrosoft.com",
     "managerId": "4cf1a461-a435-4e80-8ac6-a2d4f0a7ef71",
     "isDisabled": false,
     "isDeleted": false,
     "createdAt": "2023-11-06T16:23:29.373",
     "modifiedAt": "2025-11-20T01:00:11.897",
     "profile": null,
     "externalReferences": [],
     "identity": null
   }
 }
]