Tipo de recurso person
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una agregación de información sobre una persona de entre correo y contactos. Las personas pueden ser contactos locales o el directorio de su organización, y personas de comunicaciones recientes (por ejemplo, correo electrónico).
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List people | person | Obtenga una colección de objetos person ordenados por su relevancia para el user. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| birthday | String | Cumpleaños del contacto. |
| companyName | String | Nombre de la compañía del contacto. |
| department | String | Departamento del contacto. |
| displayName | String | Nombre para mostrar del contacto. |
| emailAddresses | Colección rankedEmailAddress | Direcciones de correo electrónico del contacto. |
| givenName | String | Nombre propio del contacto. |
| id | String | Identificador único de la persona. Solo lectura. |
| isFavorite | Boolean |
True si el usuario ha marcado este contacto como favorito. |
| mailboxType | Cadena | Tipo de buzón que se representa mediante la dirección de correo electrónico de la persona. |
| officeLocation | String | Ubicación de la oficina del contacto. |
| personNotes | String | Notas de forma libre que el usuario ha tomado sobre este contacto. |
| personType | Cadena | Tipo de persona, por ejemplo, lista de distribución. |
| phones | Colección phone | Número de teléfono del contacto. |
| postalAddresses | Colección location | Direcciones del contacto. |
| profession | String | Profesión del contacto. |
| orígenes | colección personDataSource | Los orígenes de los datos de usuario proceden, por ejemplo, de contactos de Outlook o de directorio. |
| surname | String | Apellido del contacto. |
| title | Cadena | El título de la persona. |
| userPrincipalName | String | Nombre principal de usuario (UPN) de la persona. El UPN es un nombre de inicio de sesión de estilo Internet para la persona en función de la RFC 822 estándar de Internet. Por convención, debe asignarse al nombre de correo electrónico de la persona. El formato general es alias@domain. |
| websites | Colección website | Sitios web del contacto. |
| yomiCompany | String | Nombre fonético japonés de la compañía del contacto. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"birthday": "String",
"companyName": "String",
"department": "String",
"displayName": "String",
"emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
"givenName": "String",
"id": "String (identifier)",
"isFavorite": "Boolean",
"mailboxType": "String",
"officeLocation": "String",
"personNotes": "String",
"personType": "String",
"phones": [{"@odata.type": "microsoft.graph.phone"}],
"postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
"profession": "String",
"sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
"surname": "String",
"title": "String",
"userPrincipalName": "String",
"websites": [{"@odata.type": "microsoft.graph.website"}],
"yomiCompany": "String"
}