Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Las aplicaciones de Microsoft Graph pueden usar profile API para recuperar el perfil del usuario que ha iniciado sesión u otro usuario con una Microsoft Entra ID o una cuenta de Microsoft válidas. Esta información se puede usar en aplicaciones para ayudar a contextualizar a otro usuario, proporcionando una experiencia más enriquecida para el usuario dentro de la aplicación o como un mecanismo para almacenar información extendida sobre el usuario que también se puede usar en Microsoft 365.
Autorización
Para llamar a la API de Personas en Microsoft Graph, la aplicación necesita los permisos adecuados:
- User.Read: usar para realizar llamadas generales de API de perfil; por ejemplo,
https://graph.microsoft.com/beta/me/profile/. User.Read requiere el consentimiento del usuario final.
Ver mi perfil
Las solicitudes de esta sección obtienen los contactos más relevantes para el usuario que ha iniciado sesión (/me). Estas solicitudes requieren el permiso de User.Read para estar presentes en el usuario que ha iniciado sesión.
GET https://graph.microsoft.com/beta/me/profile/
En el ejemplo siguiente se muestra la respuesta. De forma predeterminada, cada respuesta devuelve 10 registros. Puede cambiar esto mediante el parámetro de consulta $top . En este ejemplo se usa $top para limitar la respuesta a tres registros.
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": []
}