Place-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt grundlegende Standortattribute wie Name, physische Adresse und geografische Koordinaten dar. Dies ist der Basistyp für vielfältigere Ortstypen wie "room" und "roomList".

Verwenden der Orte-API

Exchange Online-Administratoren können Besprechungsräume in einem Mandanten in Raumlisten organisieren. Mithilfe der Orte-API können Sie alle Raumlisten oder Räume im Mandanten oder alle Räume in einer bestimmten Raumliste abrufen.

Orte wie "raum" und "roomList" enthalten die Basis-ID, den Anzeigenamen und die E-Mail-Adresse. Darüber hinaus enthalten sie Navigationsinformationen wie physische Adresse und geografische Koordinaten sowie bei Räumen andere relevante Informationen wie AV-Funktionen, Bodennummer und Kapazität.

Die Funktionen findRooms und findRoomLists unterstützen eine ähnliche Suche nach Räumen und Raumlisten in einem Mandanten. Es folgt ein Vergleich zwischen der Orte-API und diesen Funktionen. Wenn Sie eine Produktions-App erstellen, wählen Sie die Orte-API aus, da die API jetzt allgemein in v1.0 verfügbar ist. Planen Sie, vorhandenen Code zu aktualisieren, der findRooms oder findRoomLists für die Verwendung der Orte-API verwendet, da findRooms oder findRoomLists veraltet sind und eine Zeitachse angekündigt wird.

Orte-API	FindRooms- und findRoomLists-Funktionen
Unterstützt das Abrufen aller Räume oder Raumlisten in einem Mandanten und aller Räume in einer Raumliste.	Ähnliche Unterstützung – Alle Räume oder Raumlisten in einem Mandanten und alle Räume in einer Raumliste erhalten
Listenorte 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 einer einzelnen Raum- oder Raumliste in einem Mandanten	Unterstützt nicht das Abrufen einer einzelnen Raum- oder Raumliste in einem Mandanten
Definiert die spezifischen Entitäten von "room" und "roomList", die zusätzlich zum Anzeigenamen und der SMTP-Adresse einen reichhaltigen Eigenschaftensatz angeben.	Jede Raum- und Raumliste hat einen kleineren E-Mail-Adresstyp, der nur den Anzeigenamen und die SMTP-Adresse angibt.
Unterstützt nur Organisationsszenarien mit delegierten (Arbeits- oder Schulkonten) oder Anwendungsberechtigungen	Ähnliche Unterstützung nur für Organisationsszenarien mit delegierten oder Anwendungsberechtigungen
Unterstützt das Aktualisieren eines einzelnen Raum- oder Raumlisten in einem Mandanten	Unterstützt nicht das Aktualisieren eines einzelnen Raum- oder Raumlisten in einem Mandanten

Methoden

Methode	Rückgabetyp	Beschreibung
Orte auflisten	Eine Sammlung des angeforderten abgeleiteten Ortstyps	Hier können Sie eine Auflistung des angegebenen Typs von Ortsobjekten, die im Mandanten definiert sind, erhalten.
Get place	Der angeforderte abgeleitete Ortstyp	Die Eigenschaften und Beziehungen eines angegebenen Ortsobjekts erhalten.
Updateort	Der angeforderte abgeleitete Ortstyp	Aktualisiert die Eigenschaften und Beziehungen eines angegebenen Place-Objekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
address	physicalAddress	Die Adresse des Orts.
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	Eindeutiger Bezeichner für den Ort. Schreibgeschützt.
phone	String	Die Telefonnummer des Orts.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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

Siehe auch

• 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".