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. Personnes peuvent être des contacts locaux ou l’annuaire de votre organization, ainsi que des personnes provenant de communications récentes (par exemple, 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

Voici une représentation JSON de la 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"
}