Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Microsoft Graph-Anwendungen können die Profil-API verwenden, um das Profil des angemeldeten Benutzers oder eines anderen Benutzers mit einem gültigen Microsoft Entra ID- oder Microsoft-Konto abzurufen. Diese Informationen können in Anwendungen verwendet werden, um die Kontextualisierung eines anderen Benutzers zu unterstützen, um dem Benutzer eine umfassendere Erfahrung innerhalb der Anwendung zu bieten, oder als Mechanismus zum Speichern erweiterter Benutzerinformationen, die auch in Microsoft 365 verwendet werden können.
Authorization
Zum Aufrufen der Personen-API in Microsoft Graph benötigt Ihre App die entsprechenden Berechtigungen:
- User. Read – Verwenden, um allgemeine API-Aufrufe für Profile zu erstellen, z. B.
https://graph.microsoft.com/beta/me/profile/. User.Read erfordert die Zustimmung des Endbenutzers.
Mein Profil anzeigen
Bei den Anforderungen in diesem Abschnitt werden die für den angemeldeten Benutzer relevantesten Personen abgerufen (/me). Für diese Anforderungen muss die User.Read-Berechtigung für den angemeldeten Benutzer vorhanden sein.
GET https://graph.microsoft.com/beta/me/profile/
Das folgende Beispiel zeigt die Antwort. Standardmäßig gibt jede Antwort 10 Datensätze zurück. Sie können dies mithilfe des abfrageparameters $top ändern. In diesem Beispiel wird $top verwendet, um die Antwort auf drei Datensätze zu beschränken.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "profileId",
"anniversaries": [],
"websites": [],
"educationalActivities": [
{
"endMonthYear": null,
"startMonthYear": null,
"completionMonthYear": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "c3a9f515-4a15-456b-9bf7-690dcd7f05d7",
"program": {
"abbreviation": null,
"description": null,
"displayName": "",
"grade": null,
"notes": null,
"webUrl": null
},
"institution": {
"description": null,
"displayName": "Colorado State University",
"location": null,
"webUrl": null
},
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"emails": [
{
"address": "john.doe@contoso.com",
"displayName": null,
"type": "main",
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "046452c0-c893-4fd1-a7ca-57e2ccf13861",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"interests": [
{
"categories": [],
"description": null,
"displayName": "Microsoft Graph",
"webUrl": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "0c568cf5-5e44-4b3e-aefd-6b46ca00a880",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"languages": [
{
"displayName": "English (United States)",
"tag": "en-US",
"proficiency": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "3d34dc2e-fc84-43ff-98f6-884467caba72",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"names": [
{
"displayName": "John Doe",
"first": "John",
"initials": "JD",
"last": "Doe",
"languageTag": null,
"maiden": null,
"middle": null,
"nickname": null,
"suffix": null,
"title": null,
"pronunciation": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "b79302ca-7f05-4c89-96ce-b89d5855eb0e",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"phones": [
{
"displayName": null,
"type": "business",
"number": "+47 (9) 387654321",
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "d22aef2c-f332-4958-aac3-8d1d710a9e32",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"positions": [
{
"categories": [],
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "0f4d49c8-76cb-4d56-9f92-a10e182ba0e1",
"detail": {
"description": null,
"endMonthYear": "0001-01-01",
"jobTitle": "Associate Architect",
"startMonthYear": "0001-01-01",
"summary": null,
"company": {
"displayName": "Contoso Corporation",
"pronunciation": null,
"department": "Architecture",
"officeLocation": "",
"webUrl": null,
"address": {
"type": "business",
"postOfficeBox": null,
"street": "",
"city": "Oslo",
"state": "",
"countryOrRegion": "",
"postalCode": ""
}
}
},
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"projects": [
{
"categories": [],
"client": null,
"displayName": "Profile on Graph",
"detail": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "d6d84567-513a-47be-9be2-99fee6a12777",
"colleagues": [],
"sponsors": [],
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"skills": [
{
"categories": [],
"displayName": "REST API Design",
"proficiency": null,
"webUrl": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "9cd979f9-7a43-4dd1-a628-42bb07bd0974",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"webAccounts": []
}