ressourcentyp "place"

  • Artikel

Namespace: microsoft.graph

Stellt grundlegende Standortattribute wie Name, physische Adresse und geografische Koordinaten dar. Diese Ressource ist der Basistyp für umfangreichere Standorttypen 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.

Places wie room 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. Es wird nicht unterstützt, einen einzelnen Raum oder eine Raumliste in einem Mandanten zu erhalten.
Definiert die spezifischen Entitäten von room und roomList , die zusätzlich zum Anzeigenamen und der SMTP-Adresse einen umfangreicheren Eigenschaftensatz 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. Der Betaversion dieser API wurde eine neue Eigenschaft namens placeId hinzugefügt, die eine unveränderliche ID bereitstellt.
phone String Die Telefonnummer des Orts.

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"
}

Verwandte Inhalte