Utilisation de l’API Places dans 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 .

L’API Places dans Microsoft Graph fournit un moyen unifié de gérer et d’interagir avec des espaces physiques, tels que des bâtiments, des salles, des bureaux et des espaces de travail, au sein d’une organisation.

Types pris en charge

Les types suivants sont pris en charge par l’API Places.

Types de lieux

Place représente différents types d’espaces au sein d’un client. Un objet de lieu peut être de l’un des types suivants.

Type de lieu Détails
bâtiment Représente un bâtiment dans le locataire et possède des propriétés telles que le nom, l’adresse et les coordonnées géographiques.
de bureau Représente les bureaux individuels. Un bureau doit être ajouté à une section. Les propriétés enrichies de la section incluent l’adresse e-mail, le mode et l’accessibilité.
plancher Représente un étage dans un bâtiment, y compris des propriétés telles que name, parentId et sortOrder. Un bâtiment est toujours le parent d’un étage.
Chambre Représente une pièce dans le client. Toutes les salles doivent être associées à des boîtes aux lettres Exchange. Une pièce peut être ajoutée à un étage ou à une section. Les propriétés enrichies de la salle incluent une adresse e-mail pour la salle, l’accessibilité, la capacité, le périphérique audio, le périphérique vidéo, etc.
Liste des salles Collection de pièces dans le locataire. Places prend en charge roomList pour garantir que la réservation de salles fonctionne dans la fonction Recherche de salles sur tous les clients sur tous les appareils, par exemple Outlook classique sur les ordinateurs de bureau et mobiles.

Toutefois, nous vous recommandons de vous fier aux nouveaux types de lieux et à la hiérarchie si vous n’utilisez pas roomFinder dans le client. Pour plus d’informations sur roomList, consultez le type de ressource roomList .
section Représente une section d’un étage, y compris des propriétés telles que name, parentId et label. Un sol est toujours le parent d’une section.
espace de travail Représente un ensemble de bureaux. Tous les espaces de travail doivent être associés aux boîtes aux lettres Exchange. Un espace de travail peut être ajouté à une section. Les propriétés enrichies d’un espace de travail incluent une adresse e-mail pour l’espace de travail, le mode, l’accessibilité et la capacité.

Types d’entités cartographiques

L’entité cartographique représente la carte correspondante d’un lieu. Un objet d’entité cartographique peut être de l’un des types suivants.

Type d’entité cartographique Détails
buildingMap Représente un fichier cartographique associé à un bâtiment dans Places. Cet objet est la représentation au format IMDF de building.geojson.
fixtureMap Représente un fichier fixture.geojson au format IMDF qui définit les biens physiques mobiles ou semi-permanents dans un espace. Ces actifs soutiennent les fonctions utilitaires, de service ou esthétiques sans affecter l’intégrité structurelle.
footprintMap Représente un fichier footprint.geojson au format IMDF qui définit l’étendue physique approximative d’un bâtiment référencé.
levelMap Représente un fichier level.geojson au format IMDF qui définit la structure physique du sol dans un bâtiment.
sectionMap Représente un fichier section.geojson au format IMDF qui définit des sections (telles que des zones ou des partitions) sur le sol d’un bâtiment.
Carte unitaire Représente un fichier unit.geojson au format IMDF qui définit des unités (telles que des pièces ou des bureaux) sur un étage d’un bâtiment.

Utilisation de l’API Places

L’API Places permet aux applications disposant d’autorisations de lecture ou d’écriture appropriées d’interagir avec les objets Place. Chaque objet place inclut des propriétés fondamentales telles que id, placeId et displayName. Les types plus avancés, tels que les salles, les espaces de travail et les bureaux, offrent davantage de propriétés telles que mode, emailAddress et deviceInformation.

Les API de carte dans Places permettent aux applications disposant des autorisations de lecture ou d’écriture appropriées d’interagir avec les objets d’entités cartographiques. Chaque objet d’entité cartographique inclut des propriétés fondamentales telles que id, et d’autres propriétés telles que placeId, geometry, display_point.

Des descriptions détaillées de chaque type sont disponibles dans les sections de documentation respectives.

Prérequis pour la liste des Places et les API descendantes

Avant de pouvoir utiliser les API List place objects ou place : descendants, vous devez vous assurer que les paramètres de Places sont correctement configurés dans votre environnement Microsoft 365. Dans le cas contraire, ces API ne renvoient aucun emplacement si les étapes de configuration suivantes ne sont pas effectuées :

  1. Téléchargez le module PowerShell Microsoft Places et connectez-vous-y. Pour plus d’informations, consultez Connecter-MicrosoftPlaces.
  2. Rendez les lieux visibles en activant les bâtiments avec la commande suivante. Pour plus d’informations, consultez Set-PlacesSettings. 
    Set-PlacesSettings -EnableBuildings 'Default:true'

Cas d’utilisation courants

Le tableau suivant répertorie certaines des utilisations courantes de l’API Places.

Cas d’utilisation Ressource REST Voir aussi
Créer et gérer un lieu lieu Méthodes Place
Interagissez avec des espaces de lieux tels qu’un bâtiment, un sol, une section, une pièce, une liste de salles, un espace de travail ou un bureau lieu Méthodes Place
Insérer des lieux lieu Insérer des lieux
Ingérer le fichier de carte d’un bâtiment bâtiment Ingérer le fichier de carte
Répertorier les niveaux d’un bâtiment levelMap Niveaux de liste
Répertorier les empreintes de pas dans un bâtiment footprintMap Lister les empreintes
Obtenir et supprimer un buildingMap buildingMap Méthodes buildingMap
Créer et gérer une unitMap Carte unitaire Méthodes unitMap
Créer et gérer un fixtureMap fixtureMap Méthodes fixtureMap
Créer et gérer une sectionMap sectionMap Méthodes sectionMap

Comparaison des API Places avec findRooms et findRoomLists

Les fonctions findRooms et findRoomLists prennent en charge des recherches similaires pour les salles et les listes de salles d’un client. Le tableau suivant compare l’API Places et ces fonctions.

Remarque

Les fonctions findRooms et findRoomLists sont obsolètes.

API Places Fonctions findRooms et findRoomLists (déconseillées)
Obtient toutes les salles ou listes de salles d’un client, et toutes les salles d’une liste de salles. Obtient toutes les salles ou listes de salles d’un client, et toutes les salles d’une liste de salles.
List peut renvoyer plus de 100 chambres dans un client. findRooms renvoie jusqu’aux 100 premières salles d’un client.
Prend en charge l’obtention d’une salle individuelle ou d’une liste de salles dans un client. Ne prend pas en charge l’obtention d’une salle individuelle ou d’une liste de salles dans un client.
Définit les entités spécifiques de room et roomList qui spécifient un jeu de propriétés plus riche, en plus du nom d’affichage et de l’adresse SMTP. Chaque salle et liste de salles est d’un type emailAddress plus léger qui spécifie uniquement le nom d’affichage et l’adresse SMTP.
Prend en charge uniquement les scénarios organisationnels avec des autorisations déléguées (uniquement pour les comptes professionnels ou scolaires) ou des autorisations d’application. Prend en charge uniquement les scénarios organisationnels disposant d’autorisations déléguées ou d’application.
Prend en charge la mise à jour d’une salle individuelle ou de la liste de salles d’un client. Ne prend pas en charge la mise à jour d’une salle individuelle ou de la liste de salles d’un client.

Étapes suivantes

Utilisez les API Microsoft Graph Places pour interagir avec différentes entités de lieu. Pour en savoir plus :

  • Explorez les ressources et les méthodes les plus utiles à votre scénario.
  • Essayez l’API dans l’Afficheur Graph.
  • Dernière mise à jour :