Partager via


type de ressource contact

Espace de noms: microsoft.graph

Un contact est un élément dans Outlook dans lequel vous pouvez organiser et enregistrer des informations sur les personnes et les organisations avec lesquelles vous communiquez. Les contacts sont contenus dans les dossiers de contacts.

Cette ressource prend en charge les fonctions suivantes :

Méthodes

Méthode Type renvoyé Description
Obtenir un contact contact Lisez les propriétés et les relations de l’objet contact.
Créer un contact contact Ajoutez un contact dans le dossier Contacts racine ou au point de terminaison des contacts d’un autre dossier de contacts.
Mettre à jour un contact contact Mettez à jour un objet contact.
Supprimer le contact Aucun Supprimez un objet contact.
Obtenir le contact delta collection contact Obtenir un ensemble de contacts qui ont été ajoutés, supprimés ou mis à jour dans un dossier spécifié.
Extensions d’ouverture
Créer une extension d’ouverture openTypeExtension Crée une extension d’ouverture et ajoute des propriétés personnalisées dans une instance nouvelle ou existante d’une ressource.
Obtenir une extension d’ouverture collection openTypeExtension Obtient un objet d’extension d’ouverture ou des objets identifiés par leur nom ou leur nom complet.
Propriétés étendues
Créer une propriété à valeur unique contact Créez une ou plusieurs propriétés étendues à valeur unique dans un contact nouveau ou existant.
Obtenir une propriété à valeur unique contact Obtenez des contacts qui contiennent une propriété étendue à valeur unique à l’aide de $expand ou $filter.
Créer une propriété à valeurs multiples contact Créez une ou plusieurs propriétés étendues à valeurs multiples dans un contact nouveau ou existant.
Obtenir une propriété à valeurs multiples contact Obtenez un contact qui contient une propriété étendue à valeurs multiples à l’aide de $expand.

Propriétés

Propriété Type Description
assistantName Chaîne Nom de l’assistant du contact.
birthday DateTimeOffset Anniversaire du contact. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
businessAddress PhysicalAddress Adresse professionnelle du contact.
businessHomePage Chaîne Page d’accueil professionnelle du contact.
businessPhones Collection de chaînes Numéros de téléphone professionnels du contact.
categories Collection de chaînes Catégories associés au contact.
changeKey Chaîne Identifie la version du contact. Chaque fois que le contact est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer les modifications à la version correcte de l’objet.
children Collection de chaînes Noms des enfants du contact.
CompanyName Chaîne Nom de la société du contact.
createdDateTime DateTimeOffset Heure de création du contact. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
Service Chaîne Département du contact.
displayName Chaîne Nom d’affichage du contact. Vous pouvez spécifier le nom d’affichage dans une opération de création ou de mise à jour. Notez que des mises à jour ultérieures d’autres propriétés peuvent avoir pour effet qu’une valeur générée automatiquement remplace la valeur displayName que vous avez spécifiée. Pour conserver une valeur préexistante, incluez-la toujours en tant que displayName dans une opération de mise à jour.
emailAddresses collection EmailAddress Adresses e-mail du contact.
fileAs Chaîne Nom sous lequel le contact est classé.
generation Chaîne Suffixe du contact.
givenName Chaîne Nom du contact donné.
homeAddress PhysicalAddress Adresse personnelle du contact.
homePhones Collection de chaînes Numéros de téléphone personnels du contact.
id String Identificateur unique du contact. Par défaut, cette valeur change lorsque l’élément est déplacé d’un conteneur (tel qu’un dossier ou un calendrier) vers un autre. Pour modifier ce comportement, utilisez l’en-tête Prefer: IdType="ImmutableId". Pour plus d’informations, consultez Obtenir des identificateurs immuables pour les ressources Outlook . En lecture seule.
imAddresses Collection de chaînes Adresses de messagerie instantanée du contact.
initials Chaîne Initiales du contact.
jobTitle Chaîne Fonction du contact.
lastModifiedDateTime DateTimeOffset Heure de modification du contact. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
manager Chaîne Nom du responsable du contact.
middleName Chaîne Deuxième prénom du contact.
mobilePhone Chaîne Numéro de téléphone mobile du contact.
nickName Chaîne Surnom du contact.
officeLocation Chaîne Emplacement du bureau du contact.
otherAddress PhysicalAddress Autres adresses du contact.
parentFolderId Chaîne ID du dossier parent du contact.
personalNotes Chaîne Notes de l’utilisateur sur le contact.
profession Chaîne Profession du contact.
spouseName String Nom du conjoint/partenaire du contact.
surname Chaîne Nom de famille du contact.
title Chaîne Titre du contact.
yomiCompanyName Chaîne Nom phonétique de la société japonaise du contact.
yomiGivenName Chaîne Nom donné (prénom) phonétique japonais du contact.
yomiSurname Chaîne Nom de famille (nom) japonais phonétique du contact.

Relations

Relation Type Description
extensions collection extension Collection des extensions d’ouverture définies pour le contact. En lecture seule. Pouvant accepter la valeur Null.
multiValueExtendedProperties collection multiValueLegacyExtendedProperty Collection des propriétés étendues à plusieurs valeurs définies pour le contact. En lecture seule. Pouvant accepter la valeur Null.
photo profilePhoto Photo du contact facultative. Vous pouvez obtenir ou définir une photo pour un contact.
singleValueExtendedProperties collection singleValueLegacyExtendedProperty Collection des propriétés étendues à valeurs uniques définies pour le contact. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "assistantName": "string",
  "birthday": "String (timestamp)",
  "businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "businessHomePage": "string",
  "businessPhones": ["string"],
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
  "fileAs": "string",
  "generation": "string",
  "givenName": "string",
  "homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "homePhones": ["string"],
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "mobilePhone": "string",
  "nickName": "string",
  "officeLocation": "string",
  "otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "parentFolderId": "string",
  "personalNotes": "string",
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}