Benutzer abrufenGet a user

03.12.2020
5 Minuten Lesedauer

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Dient zum Abrufen der Eigenschaften und der Beziehungen des Benutzerobjekts.Retrieve the properties and relationships of user object.

Dieser Vorgang gibt standardmäßig nur eine Teilmenge der häufiger verwendeten Eigenschaften für jeden Benutzer zurück.This operation returns by default only a subset of the more commonly used properties for each user. Diese Standardeigenschaften werden im Abschnitt Eigenschaften aufgeführt.These default properties are noted in the Properties section. Um Eigenschaften abzurufen, die nicht standardmäßig zurückgegeben werden, führen Sie eine GET-Operation für den Benutzer aus, und geben Sie die Eigenschaften in einer $select OData-Abfrageoption an.To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Da die user-Ressource Erweiterungen unterstützt, können Sie über den GET-Vorgang auch benutzerdefinierte Eigenschaften und Erweiterungsdaten aus user-Instanzen abrufen.Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account)	User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account)	User.Read, User.ReadWriteUser.Read, User.ReadWrite
AnwendungApplication	User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Das Aufrufen des /me-Endpunkts erfordert einen angemeldeten Benutzer und daher eine delegierte Berechtigung.Calling the /me endpoint requires a signed-in user and therefore a delegated permission. Anwendungsberechtigungen werden bei der Benutzung des /me-Endpunkts nicht unterstützt.Application permissions are not supported when using the /me endpoint.

Für einen bestimmten Benutzer:For a specific user:

GET /users/{id | userPrincipalName}

Für den angemeldeten Benutzer:For the signed-in user:

GET /me

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

AnforderungsheaderRequest headers

KopfzeileHeader	WertValue
AuthorizationAuthorization	Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type	application/jsonapplication/json

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und ein user-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and user object in the response body.

Diese Methode wird 202 Accepted zurückgeben, wenn die Anforderung erfolgreich verarbeitet wurde, aber der Server mehr Zeit dazu benötigt, verbundene Hintergrundvorgänge abzuschließen.This method returns 202 Accepted when the request has been processed successfully but the server requires more time to complete related background operations.

BeispielExample

Beispiel 1: Abrufen der Eigenschaften des angemeldeten BenutzersExample 1: Get the properties of the signed-in user

AnforderungRequest

GET https://graph.microsoft.com/beta/me


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var user = await graphClient.Me
    .Request()
    .GetAsync();

Wichtig

Microsoft Graph-SDKs verwenden standardmäßig die Version v 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta Version verfügbar sind.Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. Ausführliche Informationen zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

In der SDK-Dokumentation finden Sie Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider -Instanz.Read the SDK documentation for details about how to add the SDK to your project and create an authProvider instance.


const options = {
    authProvider,
};

const client = Client.init(options);

let res = await client.api('/me')
    .version('beta')
    .get();

Wichtig


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphUser *user = [[MSGraphUser alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Wichtig


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

User user = graphClient.me()
    .buildRequest()
    .get();

Wichtig

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity.

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

{
   "displayName": "Adele Vance",
   "givenName": "Adele",
   "jobTitle": "Retail Manager",
   "mail": "AdeleV@contoso.onmicrosoft.com",
   "mobilePhone": "+1 425 555 0109",
   "officeLocation": "18/2111",
   "preferredLanguage": "en-US",
   "surname": "Vance",
   "userPrincipalName": "AdeleV@contoso.onmicrosoft.com",
   "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd"
}

Beispiel 2: Abrufen der Eigenschaften des angegebenen BenutzersExample 2: Get the properties of the specified user

AnforderungRequest

Das folgende Beispiel zeigt eine Anfrage.The following example shows a request.

GET https://graph.microsoft.com/beta/users/{id}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var user = await graphClient.Users["{id}"]
    .Request()
    .GetAsync();

Wichtig


const options = {
    authProvider,
};

const client = Client.init(options);

let res = await client.api('/users/{id}')
    .version('beta')
    .get();

Wichtig


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/{id}"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphUser *user = [[MSGraphUser alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Wichtig


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

User user = graphClient.users("{id}")
    .buildRequest()
    .get();

Wichtig

AntwortResponse

Das folgende Beispiel zeigt die Antwort.The following example shows the response.

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

{
      "displayName": "Adele Vance",
      "givenName": "Adele",
      "jobTitle": "Retail Manager",
      "mail": "AdeleV@contoso.onmicrosoft.com",
      "mobilePhone": "+1 425 555 0109",
      "officeLocation": "18/2111",
      "preferredLanguage": "en-US",
      "surname": "Vance",
      "userPrincipalName": "AdeleV@contoso.onmicrosoft.com",
      "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd"
}

Benutzer abrufenGet a user

BerechtigungenPermissions

Optionale AbfrageparameterOptional query parameters

AnforderungsheaderRequest headers

AnforderungstextRequest body

AntwortResponse

BeispielExample

Beispiel 1: Abrufen der Eigenschaften des angemeldeten BenutzersExample 1: Get the properties of the signed-in user

AnforderungRequest

AntwortResponse

Beispiel 2: Abrufen der Eigenschaften des angegebenen BenutzersExample 2: Get the properties of the specified user

AnforderungRequest

AntwortResponse

Siehe auchSee also

Ist diese Seite hilfreich?

Ist diese Seite hilfreich?