orgType de ressource

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’une organisation et sont différents des contacts personnels. En outre, les contacts de l’organisation sont synchronisés à partir d’annuaires 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 autorise des propriétés supplémentaires au-delà de celles documentées ici.

Méthodes

Méthode Type renvoyé Description
Contacts organisationnels
List Collection orgContact Propriétés de liste des contacts de l’organisation.
Obtenir orgContact Lisez les propriétés et les relations de l’objet orgContact.
Obtenir delta Collection orgContact Obtenez des contacts organisationnels nouvellement créés, mis à jour ou supprimés sans avoir à effectuer une lecture complète de la collection entière.
Obtenir delta pour l’objet de répertoire collection direcyoryObject Obtenez des 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 la collection entière.
Répertorier les membres de String collection Récupérez la liste des groupes et des unités administratives dont le contact est membre. La vérification est transitive.
Liste des membres transitifs de collection directoryObject Répertoriez les groupes dont un contact organisationnel est membre, y compris les groupes dans 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 Renvoyer 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 à une liste de groupes, de rôles d’annuaire ou d’objets d’unité administrative.
Obtenir des objets de membre String collection Renvoyer tous les groupes, unités administratives et rôles d’annuaire auxquels le contact organisationnel appartient. La vérification est transitive.
Réessayer de provisionner le service Aucun Réessayez le provisionnement du service orgContact.
Obtenir des rapports transitifs Entier Obtenez le nombre de rapports transitifs pour un contact d’organisation à partir de la propriété de navigation transitiveReports.
Comportement de synchronisation locale (source d’autorité)
Obtenir onLocalSyncBehavior Vérifiez si la source d’autorité (SOA) de l’objet contact est le cloud ou le Active Directory local.
Mettre à jour onLocalSyncBehavior Mettez à jour la source d’autorité (SOA) de l’objet contact sur le cloud ou Active Directory local.
Hiérarchie organisationnelle
Obtenir le gestionnaire directoryObject Obtenir le responsable du contact.
Répertorier les rapports de collaborateurs collection directoryObject Répertoriez les rapports directs du contact.

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, voir Fonctionnalités de requête avancées sur les objets d’annuaire.

Propriété Type Description
Adresses IP collection physicalOfficeAddress Adresses postales de ce contact organisationnel. Pour le moment, 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, ge, inlestartsWith, et eq pour null les valeurs).
Service String Nom du service dans lequel le contact travaille. Prend en charge $filter (eq, ne, not, ge, inlestartsWith, et eq pour null les valeurs).
displayName String Nom complet de ce contact organisationnel. Longueur maximale : 256 caractères. Prend en charge $filter (eq, ne, not, ge, inlestartsWithet eq pour null les valeurs), $search, et .$orderby
givenName String Prénom de ce contact organisationnel. Prend en charge $filter (eq, ne, not, ge, inlestartsWith, 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 pour ce contact organisationnel. Prend en charge $filter (eq, ne, not, ge, inlestartsWith, et eq pour null les valeurs).
messagerie String Adresse SMTP du contact, par exemple, «jeff@contoso.com ». Prend en charge $filter (eq, ne, not, ge, inlestartsWith, et eq pour null les valeurs).
mailNickname String Alias d’Email (partie de l’adresse e-mail précédant le symbole @) pour ce contact organisationnel. Prend en charge $filter (eq, ne, not, ge, inlestartsWith, 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 de configuration de la synchronisation pour ce contact organisationnel. Supports $filter (eq, not pour la catégorie et la propriétéCausingError), /$count eq 0, /$count ne 0.
onPremisesSyncEnabled Booléen true si cet objet est synchronisé à partir d’un répertoire local ; false si cet objet a été synchronisé à l’origine à 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 (par défaut).

Prend en charge $filter (eq, ne, innot, et eq pour null les valeurs).
phones Collection phone Liste des téléphones pour ce contact organisationnel. Les types de téléphone peuvent être mobile, professionnel et professionnelFax. Un seul exemplaire de chaque 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 à partir d’un objet orgContact.
Prend en charge $filter (eq, not, pour isResolved et serviceInstance).
surname String Nom de ce contact organisationnel. Prend en charge $filter (eq, ne, not, ge, inlestartsWith, 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é gestionnaire est définie sur ce contact.) 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 Les groupes dont ce contact est membre. En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand.
onLocalSyncBehavior onLocalSyncBehavior Indique l’état de synchronisation d’un orgContact entre le cloud et Active Directory Active Directory local. Prend en charge $filter uniquement avec des fonctionnalités de requête avancées, par exemple. $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true
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"
}
  • Last updated on