ressourcentyp "place"

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt grundlegende Standortattribute wie Name, physische Adresse und geografische Koordinaten dar. Diese Ressource ist der Basistyp für umfangreichere Standorttypen wie room, workspace und roomList.

Verwenden der Orte-API

Exchange Online Können Administratoren Besprechungsräume und Arbeitsbereiche in einem Mandanten in Raumlisten organisieren. Mithilfe der Orte-API können Sie den Listenvorgang verwenden, um alle Räume, Arbeitsbereiche oder Raumlisten im Mandanten abzurufen oder die Räume und Arbeitsbereiche in einer bestimmten Raumliste abzurufen.

Places wie room, workspace und roomList enthalten die grundlegende ID, den Anzeigenamen und die E-Mail-Adresse. Darüber hinaus enthalten sie Navigationsinformationen wie physische Adressen und geografische Koordinaten sowie im Falle von Räumen andere relevante Informationen wie AV-Funktionen, Bodennummer und Kapazität.

Die Funktionen findRooms und findRoomLists unterstützen ähnliche Suchvorgänge für Räume und Raumlisten in einem Mandanten. In der folgenden Tabelle werden die Orte-API und diese Funktionen verglichen.

Hinweis: Die Funktionen findRooms und findRoomLists sind veraltet.

Places-API	findRooms- und findRoomLists-Funktionen (veraltet)
Ruft alle Räume oder Raumlisten in einem Mandanten und alle Räume in einer Raumliste ab.	Ruft alle Räume oder Raumlisten in einem Mandanten und alle Räume in einer Raumliste ab.
Listenplätze können mehr als 100 Räume in einem Mandanten zurückgeben.	findRooms gibt bis zu den ersten 100 Räumen in einem Mandanten zurück.
Unterstützt das Abrufen eines einzelnen Raums oder einer Raumliste in einem Mandanten.	Unterstützt nicht das Abrufen eines einzelnen Raums oder einer Raumliste in einem Mandanten.
Definiert die spezifischen Entitäten von room und roomList , die einen umfangreicheren Eigenschaftensatz, den Anzeigenamen und die SMTP-Adresse angeben.	Jede Raum- und Raumliste weist einen leichteren emailAddress-Typ auf, der nur den Anzeigenamen und die SMTP-Adresse angibt.
Unterstützt nur Organisationsszenarien mit delegierten (Geschäfts-, Schul- oder Unikonten) oder Anwendungsberechtigungen.	Unterstützt nur Organisationsszenarien mit delegierten oder Anwendungsberechtigungen.
Unterstützt das Aktualisieren eines einzelnen Raums oder einer Raumliste in einem Mandanten.	Die Aktualisierung eines einzelnen Raums oder einer Raumliste in einem Mandanten wird nicht unterstützt.

Methoden

Methode	Rückgabetyp	Beschreibung
Orte auflisten	Eine Auflistung des angeforderten, abgeleiteten Ortstyps	Ruft eine Auflistung des angegebenen Typs von Ortsobjekten ab, die im Mandanten definiert sind.
Platz abrufen	Der angeforderte, abgeleitete Ortstyp	Ruft die Eigenschaften und Beziehungen eines angegebenen Ortsobjekts ab.
Ort aktualisieren	Der angeforderte, abgeleitete Ortstyp	Aktualisieren sie die Eigenschaften und Beziehungen eines angegebenen Ortsobjekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
address	physicalAddress	Die Adresse des Ortes.
displayName	String	Der Name, der dem Ort zugeordnet ist.
geoCoordinates	outlookGeoCoordinates	Gibt die Ortsposition in Breiten-, Längen- und (optional) Höhenkoordinaten an.
id	String	Ein eindeutiger Bezeichner für den Ort. Schreibgeschützt. Dieser Bezeichner ist nicht unveränderlich und kann sich ändern, wenn Änderungen am Postfach oder an der Mandantenkonfiguration vorgenommen werden.
phone	String	Die Telefonnummer des Orts.
placeId	String	Ein eindeutiger, unveränderlicher Bezeichner für den Ort. Schreibgeschützt. Der Wert dieses Bezeichners ist gleich der ExternalDirectoryObjectId , die Get-Mailbox vom Cmdlet zurückgegeben wird.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String",
  "placeId": "String (alternate identifier)"
}

Verwandte Inhalte

• Damit Administratoren eine Raumliste erstellen können, verwenden Sie das Exchange PowerShell-Cmdlet New-DistributionGroup.
• Damit Administratoren einer Raumliste einen Raum hinzufügen können, verwenden Sie das Exchange PowerShell-Cmdlet Add-DistributionGroupMember.