type de ressource de place

Espace de noms: microsoft.graph

Représente les attributs d’emplacement de base tels que le nom, l’adresse physique et les coordonnées géographiques. Cette ressource est le type de base pour les types d’emplacements plus riches tels que room et roomList.

Utilisation de l’API places

Exchange Online administrateurs peuvent organiser des salles de réunion dans un locataire en listes de salles. À l’aide de l’API lieux, vous pouvez obtenir toutes les listes de salles ou salles dans le locataire, ou obtenir toutes les salles d’une liste de salles spécifique.

Places comme room et roomList contiennent l’ID de base, le nom complet et l’adresse e-mail. En outre, ils contiennent des informations de navigation telles que l’adresse physique et les coordonnées géographiques, et dans le cas des salles, d’autres informations pertinentes telles que les fonctionnalités av, le numéro d’étage et la capacité.

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

Note: Les fonctions findRooms et findRoomLists sont déconseillées.

API Places Fonctions findRooms et findRoomLists (déconseillées)
Obtient toutes les salles ou listes de salles d’un locataire, ainsi que toutes les salles d’une liste de salles. Obtient toutes les salles ou listes de salles d’un locataire, ainsi que toutes les salles d’une liste de salles.
Les lieux de liste peuvent retourner plus de 100 salles dans un locataire. findRooms retourne jusqu’aux 100 premières chambres d’un locataire.
Prend en charge l’obtention d’une salle individuelle ou d’une liste de salles dans un locataire. Il ne prend pas en charge l’obtention d’une salle individuelle ou d’une liste de salles dans un locataire.
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 de poids 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 (comptes professionnels ou scolaires) ou d’application. Prend en charge uniquement les scénarios organisationnels avec des autorisations déléguées ou d’application.
Prend en charge la mise à jour d’une salle individuelle ou d’une liste de salles dans un locataire. Ne prend pas en charge la mise à jour d’une salle individuelle ou d’une liste de salles dans un locataire.

Méthodes

Méthode Type renvoyé Description
Répertorier les lieux Collection du type d’emplacement dérivé demandé Obtient une collection du type spécifié d’objets place définis dans le locataire.
Obtenir l’emplacement Type d’emplacement dérivé demandé Obtient les propriétés et les relations d’un objet place spécifié.
Emplacement de mise à jour Type d’emplacement dérivé demandé Mettez à jour les propriétés et les relations d’un objet place spécifié.

Propriétés

Propriété Type Description
address physicalAddress Adresse postale de l’endroit.
displayName Chaîne Nom associé à l’emplacement.
geoCoordinates outlookGeoCoordinates Spécifie l’emplacement dans les coordonnées de latitude, de longitude et (éventuellement) d’altitude.
id Chaîne Identificateur unique de l’emplacement. En lecture seule. Cet identificateur n’est pas immuable et peut changer en cas de modification de la boîte aux lettres ou de la configuration du locataire. La version bêta de cette API a ajouté une nouvelle propriété appelée placeId, qui fournit un ID immuable.
phone Chaîne Numéro de téléphone de l’endroit.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String"
}
  • Pour que les administrateurs créent une liste de salles, utilisez l’applet de commande Exchange PowerShell New-DistributionGroup.
  • Pour que les administrateurs ajoutent une salle à une liste de salles, utilisez l’applet de commande Exchange PowerShell Add-DistributionGroupMember.