type de ressource orgContact

  • Article

Espace de noms: microsoft.graph

Représente un contact organisationnel. Les contacts organisationnels sont gérés par les administrateurs d’une organisation et sont différents des contacts personnels. En outre, les contacts de l’organisation sont synchronisés à partir de répertoires locaux ou d’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 Collection de chaînes Retourne tous les groupes dont le contact organisationnel est membre. La vérification est transitive.
Vérifier les objets membres Collection de chaînes 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 Aucune 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 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 Alias d’e-mail (partie de l’adresse e-mail avant l’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"
}