Partager via


type de ressource de place

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 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, workspace et roomList.

Utilisation de l’API places

Exchange Online administrateurs peuvent organiser des salles de réunion et des espaces de travail dans un locataire en listes de salles. À l’aide de l’API places, vous pouvez utiliser l’opération de liste pour obtenir toutes les salles, espaces de travail ou listes de salles dans le locataire, ou obtenir les salles et espaces de travail d’une liste de salles spécifique.

Places comme room, workspace 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. 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, le nom complet et 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.
phone Chaîne Numéro de téléphone de l’endroit.
placeId Chaîne Identificateur unique et immuable de l’emplacement. En lecture seule. La valeur de cet identificateur est égale à l’ExternalDirectoryObjectId retourné par l’applet Get-Mailbox de commande .

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",
  "placeId": "String (alternate identifier)"
}
  • 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.