Partager via

type de ressource contact

  • Article

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 .

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 contact Lisez les propriétés et les relations de l’objet contact.
Créer contact Ajoutez un contact dans le dossier Contacts racine ou au point de terminaison des contacts d’un autre dossier de contacts.
Mettre à jour contact Mettez à jour un objet contact.
Supprimer Aucun Supprimez un objet contact.
Supprimer définitivement Aucune Supprimez définitivement un contact et placez-le dans le dossier Purges du dossier Éléments récupérables de la boîte aux lettres de l’utilisateur.
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éer une extension d’ouverture et ajouter des propriétés personnalisées dans une ressource nouvelle ou existante.
Obtenir une extension d’ouverture collection openTypeExtension Obtenir une extension d’ouverture identifiée par le nom de l’extension.
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.
categories Collection de chaînes Catégories associés au contact. Chaque catégorie correspond à la propriétédisplayNamed’unoutlookCategorydéfini pour l’utilisateur.
changeKey Chaîne Identifie la version du contact. Chaque fois que le contact est modifié, changeKey change également, ce qui permet à Exchange d’appliquer des 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. Les mises à jour ultérieures apportées à d’autres propriétés peuvent entraîner le remplacement d’une valeur générée automatiquement par 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 typedEmailAddress Adresses e-mail du contact.
fileAs Chaîne Nom sous lequel le contact est classé.
flag followupFlag Valeur de l’indicateur qui indique l’état, la date de début, la date d’échéance ou la date d’achèvement du contact.
gender Chaîne Sexe du contact.
generation Chaîne Suffixe du contact.
givenName Chaîne Nom du contact donné.
id Chaîne 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.
nickName Chaîne Surnom du contact.
officeLocation Chaîne Emplacement du bureau du contact.
parentFolderId Chaîne ID du dossier parent du contact.
personalNotes Chaîne Notes de l’utilisateur sur le contact.
phones Collection phone Numéros de téléphone associés au contact, par exemple, les numéros du téléphone résidentiel, du téléphone mobile et du téléphone professionnel.
postalAddresses collection physicalAddress Adresses associées au contact, par exemple, l’adresse personnelle et l’adresse professionnelle.
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.
websites Collection website Sites Web associés au contact.
weddingAnniversary Date L’anniversaire de mariage 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. 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 photo 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)",
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.typedEmailAddress"}],
  "fileAs": "string",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "gender": "string",
  "generation": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "nickName": "string",
  "officeLocation": "string",
  "parentFolderId": "string",
  "personalNotes": "string",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.physicalAddress"}],
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "weddingAnniversary": "date",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}

Contenu connexe