type de ressource person
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente une agrégation d’informations sur une personne dans le courrier et les contacts. Les personnes peuvent être des contacts locaux ou l’annuaire de votre organisation, ainsi que des personnes provenant de communications récentes (telles que des e-mails).
Méthodes
Méthode | Type renvoyé | Description |
---|---|---|
Répertorier des contacts | person | Obtenez une collection d’objets person classés selon leur pertinence pour l’utilisateur (user). |
Propriétés
Propriété | Type | Description |
---|---|---|
birthday | String | Anniversaire de la personne. |
companyName | String | Nom de société de la personne. |
Service | String | Service de la personne. |
displayName | String | Nom complet de la personne. |
emailAddresses | collection rankedEmailAddress | Adresses e-mail du contact. |
givenName | String | Prénom du contact. |
id | String | Identificateur unique de la personne. En lecture seule. |
isFavorite | Boolean |
True si l’utilisateur a ajouté cette personne aux favoris. |
mailboxType | Chaîne | Type de boîte aux lettres représenté par l’adresse e-mail de la personne. |
officeLocation | String | Emplacement du bureau de la personne. |
personNotes | String | Notes au format libre que l’utilisateur a prises sur cette personne. |
personType | Chaîne | Type de personne, par exemple liste de distribution. |
phones | Collection phone | Numéros de téléphone de la personne. |
postalAddresses | Collection location | Adresses de la personne. |
profession | String | Profession de la personne. |
sources | collection personDataSource | Les sources dont proviennent les données utilisateur, par exemple Annuaire ou Contacts Outlook. |
surname | String | Nom de famille de la personne. |
title | Chaîne | Le titre de la personne. |
userPrincipalName | String | Nom d’utilisateur principal (UPN) de la personne. L’UPN est un nom de connexion de style Internet pour la personne basée sur la norme Internet RFC 822. Par convention, cela doit être mappé au nom de l’e-mail de la personne. Le format général est alias@domain . |
websites | Collection website | Sites web de la personne. |
yomiCompany | String | Nom japonais phonétique de la société de la personne. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"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"
}