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