place resource type

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 verschiedene Raumtypen innerhalb eines Mandanten dar. Weitere Informationen finden Sie unter Arbeiten mit der Places-API in Microsoft Graph.

Basistyp von Gebäude, Schreibtisch, Etage, Raum, Raumliste, Abschnitt und Arbeitsbereich.

Methoden

Methode Rückgabetyp Beschreibung
Orte auflisten Sammlung platzieren Abrufen einer Auflistung des angegebenen Typs von Ortsobjekten , die in einem Mandanten definiert sind.
Ort erstellen place Erstellen Sie ein neues Ortsobjekt .
Ort abrufen place Lesen Sie die Eigenschaften eines Ortsobjekts . Gibt den angeforderten abgeleiteten Ortstyp zurück.
Ort aktualisieren place Aktualisieren Sie die Eigenschaften des Ortsobjekts , bei dem es sich um ein Gebäude, eine Etage, einen Abschnitt, einenSchreibtisch, einen Raum, einen Arbeitsbereich oder eine Raumliste handeln kann.
Ort löschen Keine Löschen eines Ortsobjekts .
Nachgeordnete Elemente auflisten Sammlung platzieren Ruft alle Nachkommen eines bestimmten Typs unter einem Ort ab.
Check-In-Anspruch erstellen checkInClaim Erstellen Sie ein neues checkInClaim-Objekt, um den Check-in-Status für einen bestimmten Ort aufzuzeichnen, z. B. einen Schreibtisch, einen Raum oder einen Arbeitsbereich, der mit einer bestimmten Kalenderreservierung verbunden ist.
Upsert von Orten Header „Location“ Upsert ein oder mehrere Place-Objekte im asynchronen Modus.
Vorgang abrufen placeOperation Rufen Sie einen placeOperation nach ID ab.
Vorgänge auflisten placeOperation-Sammlung Listen Sie alle vorhandenen placeOperation-Objekte auf.

Eigenschaften

Eigenschaft Typ Beschreibung
address physicalAddress Die physische Adresse des Ortes, einschließlich Straße, Stadt, Bundesland, Land oder Region und Postleitzahl.
customProperties stringDictionary Benutzerdefinierte Eigenschaften für die Stelle. Jede Eigenschaft verfügt über einen Zeichenfolgenschlüssel und einen Zeichenfolgenwert. Nullwerte zulassend.
displayName Zeichenfolge Der Name, der dem Ort zugeordnet ist.
geoCoordinates outlookGeoCoordinates Gibt die Ortsposition in Breiten-, Längen- und (optional) Höhenkoordinaten an.
id Zeichenfolge Der eindeutige Bezeichner für den Ort. Schreibgeschützt. Diese Kennung ist nicht unveränderlich und kann sich ändern, wenn sich die Postfach- oder Mandantenkonfiguration ändert.
isWheelChairAccessible Boolean Gibt an, ob der Ort für Rollstuhlfahrer zugänglich ist.
label Zeichenfolge Benutzerdefinierte Beschreibung des Ortes.
lastUpdatedTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Ort zuletzt aktualisiert wurde. Der Zeitstempel ist im ISO 8601-Format und immer in UTC. Schreibgeschützt. Nullwerte zulassend.
parentId Zeichenfolge Die ID eines übergeordneten Ortes.
phone Zeichenfolge Die Telefonnummer des Ortes.
placeId Zeichenfolge Ein stabiler Bezeichner auf Leistungsebene für das Place-Objekt, das von Places-Workloads verwendet wird.
tags Zeichenfolgenauflistung Benutzerdefinierte Tags, die dem Ort für die Kategorisierung oder Filterung zugeordnet sind.

Beziehungen

Beziehung Typ Beschreibung
checkIns checkInClaim-Sammlung Eine Unterressource eines place-Objekts, die den Check-in-Status eines Outlook-Kalenderereignisses anzeigt, das am Ort gebucht wurde.
Untergeordnetes Element Sammlung platzieren Eine Sammlung von untergeordneten Orten, die nur in der Upsert Places-API verwendet wird.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.place",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "customProperties": {"String": "String"},
  "displayName": "String",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "id": "String (identifier)",
  "isWheelChairAccessible": "Boolean",
  "label": "String",
  "lastUpdatedTime": "String (timestamp)",
  "parentId": "String",
  "phone": "String",
  "placeId": "String (alternative identifier)",
  "tags": ["String"]
}

Arbeiten mit der Places-API in Microsoft Graph