type de ressource orgContact

Espace de noms: microsoft.graph

Représente un contact organisationnel. Les contacts organisationnels sont gérés par les administrateurs d’un organization et sont différents des contacts personnels. En outre, les contacts de l’organisation sont synchronisés à partir de répertoires locaux ou de Exchange Online et sont en lecture seule dans Microsoft Graph.

Hérite de directoryObject.

Cette ressource prend en charge l’utilisation d’une requête delta pour effectuer un suivi des suppressions, des mises à jour et des ajouts incrémentiels à l’aide d’une fonction delta. Cette ressource est un type ouvert qui permet de transmettre d’autres propriétés.

Méthodes

Méthode	Type renvoyé	Description
Contacts organisationnels
Répertorier les contacts de l’organisation	orgContact	Répertorier les propriétés des contacts de l’organisation.
Obtenir un contact organisationnel	orgContact	Lire les propriétés et les relations d’un contact organisationnel.
Hiérarchie organisationnelle
Obtenir le gestionnaire	directoryObject	Obtenez le responsable du contact organisationnel.
Répertorier les objets directReports	collection directoryObject	Répertorier les rapports directs du contact organisationnel.
Répertorier memberOf	collection directoryObject	Répertorier les groupes dont un contact organisationnel est membre.
Répertorier transitiveMemberOf	collection directoryObject	Répertorier les groupes dont un contact organisationnel est membre, y compris les groupes sous lesquels le contact organisationnel est imbriqué.
checkMemberGroups	String collection	Vérifiez l’appartenance au groupe.
getMemberGroups	String collection	Retourne tous les groupes dont le contact organisationnel spécifié est membre.
getMemberObjects	String collection	Retourne une liste de directoryObjects dont le contact organisationnel est membre.

Propriétés

Importante

L’utilisation spécifique de $filter et du paramètre de requête $search n’est prise en charge que lorsque vous utilisez l’en-tête ConsistencyLevel défini sur eventual et $count. Pour plus d’informations, consultez Fonctionnalités de requête avancées sur les objets d’annuaire.

Propriété	Type	Description
Adresses	collection physicalOfficeAddress	Adresses postales de ce contact organisationnel. Pour l’instant, un contact ne peut avoir qu’une seule adresse physique.
CompanyName	Chaîne	Nom de l’entreprise à laquelle appartient ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
Service	Chaîne	Nom du service dans lequel le contact travaille. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
displayName	Chaîne	Nom d’affichage de ce contact organisationnel. Prend en charge $filter (eq, ne, genot, le, in, startsWith, et eq pour null les valeurs), $searchet $orderby.
givenName	Chaîne	Prénom de ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
id	Chaîne	Identificateur unique pour ce contact organisationnel. Prend en charge $filter (eq, ne, not, in).
jobTitle	Chaîne	Poste de ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
messagerie	String	Adresse SMTP du contact, par exemple «jeff@contoso.com ». Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
mailNickname	Chaîne	Email’alias (partie de l’adresse e-mail en attente du symbole @) pour ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
serviceProvisioningErrors	collection serviceProvisioningError	Erreurs publiées par un service fédéré décrivant une erreur non temporaire spécifique au service concernant les propriétés ou le lien d’un objet contact d’organisation . Prend en charge $filter (eq, not, pour isResolved et serviceInstance).
onPremisesLastSyncDateTime	DateTimeOffset	Date et heure de la dernière synchronisation de ce contact organisationnel à partir d’AD local. Ces informations de date et d’heure utilisent le format ISO 8601 et sont toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Prend en charge $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	collectionOnPremisesProvisioningError	Liste des erreurs d’approvisionnement de synchronisation pour ce contact organisationnel. Prend en charge $filter (eq, not pour category et propertyCausingError), /$count eq 0, /$count ne 0.
onPremisesSyncEnabled	Boolean	true si cet objet est synchronisé à partir d’un répertoire local ; false si cet objet a été initialement synchronisé à partir d’un répertoire local, mais n’est plus synchronisé et désormais maîtrisé dans Exchange ; null si cet objet n’a jamais été synchronisé à partir d’un répertoire local (valeur par défaut). Prend en charge $filter (eq, ne, notin, et eq pour les null valeurs).
phones	Collection phone	Liste des téléphones pour ce contact organisationnel. Les types de téléphone peuvent être mobiles, professionnels et businessFax. Un seul type peut être présent dans la collection.
proxyAddresses	String collection	Par exemple : « SMTP : bob@contoso.com», « smtp : bob@sales.contoso.com». L’opérateur any est requis pour les expressions de filtre sur des propriétés à valeurs multiples. Prend en charge $filter (eq, not, ge, le, startsWith, /$count eq 0, /$count ne 0).
surname	Chaîne	Nom de ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).

Relations

Relation	Type	Description
directReports	collection directoryObject	Les rapports directs du contact. (Les utilisateurs et les contacts dont la propriété de gestionnaire est définie sur ce contact.) En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand.
manager	directoryObject	L’utilisateur ou le contact qui est le responsable de ce contact. En lecture seule. Prend en charge $expand et $filter (eq) par id.
memberOf	collection directoryObject	Groupes dont ce contact est membre. En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand.
transitiveMemberOf	collection directoryObject	Groupes dont ce contact est membre, y compris les groupes sous lesquels le contact est imbriqué. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

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

{
  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "surname": "string"
}