type de ressource orgContact

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 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 collection orgContact Répertorier les propriétés des contacts de l’organisation.
Obtenir un contact organisationnel orgContact Lit les propriétés et les relations de l’objet orgContact.
Hiérarchie organisationnelle
Obtenir le gestionnaire directoryObject Obtenez le responsable du contact.
Obtenir transitiveReports Entier Obtenez le nombre de rapports transitifs pour un contact organization à partir de la propriété de navigation transitiveReports.
Répertorier les objets directReports collection directoryObject Répertorier les rapports directs du contact.
Répertorier memberOf collection directoryObject Obtient une collection d’objets memberOf.
checkMemberGroups String collection Vérifiez l’appartenance au groupe.
getMemberGroups String collection Retourne tous les groupes dont le contact spécifié est membre.
checkMemberObjects Collection de chaînes Vérifiez l’appartenance aux groupes, aux unités administratives et aux rôles d’annuaire.
getMemberObjects String collection Obtenez la liste des groupes, des unités administratives et des rôles d’annuaire dont le contact 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 la société à 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).
onPremisesLastSyncDateTime DateTimeOffset Date et heure de la dernière synchronisation de ce contact organisationnel à partir d’AD local. 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. 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. Prend en charge $filter (eq, ne, not, in).
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).
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 orgContact .
Prend en charge $filter (eq, not, pour isResolved et serviceInstance).
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.
transitiveReports collection directoryObject Rapports transitifs pour un contact. En lecture seule.

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"
}