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
List	orgContact	Répertorier les propriétés des contacts de l’organisation.
Obtenir	orgContact	Lire les propriétés et les relations d’un contact organisationnel.
Obtenir delta	collection orgContact	Obtenez les contacts organisationnels nouvellement créés, mis à jour ou supprimés sans avoir à effectuer une lecture complète de l’ensemble de la collection.
Obtenir le delta de l’objet directory	collection direcyoryObject	Obtenez les contacts organisationnels nouvellement créés, mis à jour ou supprimés via la collection d’objets d’annuaire sans avoir à effectuer une lecture complète de l’ensemble de la collection.
Répertorier les membres de	String collection	Récupérez la liste des groupes et des unités d’administration dont le contact est membre. La vérification est transitive.
Lister les membres transitifs de	collection directoryObject	Répertorier les groupes dont un contact organisationnel est membre, y compris les groupes sous lesquels le contact organisationnel est imbriqué.
Vérifier des groupes de membres	String collection	Vérifiez l’appartenance d’un contact organisationnel dans une liste de groupes. La vérification est transitive.
Obtenir des groupes de membres	String collection	Retourne tous les groupes dont le contact organisationnel est membre. La vérification est transitive.
Vérifier les objets membres	String collection	Vérifiez l’appartenance d’un contact organisationnel dans une liste de groupes, de rôle d’annuaire ou d’objets d’unité administrative.
Obtenir des objets de membre	String collection	Retourne tous les groupes, unités administratives et rôles d’annuaire dont le contact organisationnel est membre. La vérification est transitive.
Nouvelle tentative d’approvisionnement du service	Aucun	Réessayez l’approvisionnement du service orgContact.
Hiérarchie organisationnelle
Obtenir le gestionnaire	directoryObject	Obtenez le responsable du contact organisationnel.
Répertorier les rapports de collaborateurs	collection directoryObject	Répertorier les rapports directs du contact organisationnel.

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	String	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	String	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	String	Nom d’affichage de ce contact organisationnel. Longueur maximale : 256 caractères. Prend en charge $filter (eq, ne, genot, le, in, startsWith, et eq pour null les valeurs), $searchet $orderby.
givenName	String	Prénom de ce contact organisationnel. Prend en charge $filter (eq, ne, not, lege, in, startsWith, et eq pour null les valeurs).
id	String	Identificateur unique pour ce contact organisationnel. Prend en charge $filter (eq, ne, not, in).
jobTitle	String	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	String	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	String	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"
}