Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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"]
}