Feedback Bearbeiten

Place-Ressourcentyp

  • Artikel
  • 2 Minuten Lesedauer

Namespace: microsoft.graph

Stellt grundlegende Standortattribute wie Name, physische Adresse und geografische Koordinaten dar. Dies ist der Basistyp für umfangreichere Standorttypen wie Raum 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 grundlegende ID, den Anzeigenamen und die E-Mail-Adresse. Darüber hinaus enthalten sie Navigationsinformationen wie physische Adresse und geografische Koordinaten sowie im Fall von Räumen andere relevante Informationen wie AV-Funktionen, Bodennummer und Kapazität.

Die Funktionen findRooms und findRoomLists unterstützen ähnliche Nachschlagevorgänge für Räume 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 verwendet, um die Orte-API zu verwenden, da findRooms oder findRoomLists veraltet ist 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 – Abrufen aller Räume oder Raumlisten in einem Mandanten und aller Räume in einer Raumliste
Listenplätze können mehr als 100 Räume in einem Mandanten zurückgeben findRooms gibt bis zu den ersten 100 Räume in einem Mandanten zurück
Unterstützt das Abrufen einer einzelnen Raum- oder Raumliste in einem Mandanten Das Abrufen einer einzelnen Raum- oder Raumliste in einem Mandanten wird nicht unterstützt.
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 Ähnliche Unterstützung nur für Organisationsszenarien mit delegierten oder Anwendungsberechtigungen
Unterstützt das Aktualisieren einer einzelnen Raum- oder Raumliste in einem Mandanten. Das Aktualisieren einer einzelnen Raum- oder Raumliste in einem Mandanten wird nicht unterstützt.

Methoden

Methode Rückgabetyp Beschreibung
Orte auflisten Eine Auflistung des angeforderten, abgeleiteten Ortstyps Dient zum Abrufen einer Auflistung des angegebenen Typs von Ortsobjekten, die im Mandanten definiert sind.
Ort abrufen Der angeforderte, abgeleitete Ortstyp Dient zum Abrufen der Eigenschaften und Beziehungen eines angegebenen Place-Objekts .
Ort aktualisieren Der angeforderte, abgeleitete Ortstyp Dient zum Aktualisieren der Eigenschaften und Beziehungen eines angegebenen Place-Objekts .

Eigenschaften

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

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