Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents different space types within a tenant. For more information, see Working with the Places API in Microsoft Graph.
Base type of building, desk, floor, room, roomList, section, and workspace.
Methods
| Method | Return type | Description |
|---|---|---|
| List | place collection | Get a collection of the specified type of place objects defined in a tenant. |
| Create | place | Create a new place object. |
| Get | place | Read the properties of a place object. Returns the requested, derived type of place. |
| Update | place | Update the properties of place object that can be a building, floor, section, desk, room, workspace, or roomList. |
| Delete | None | Delete a place object. |
| Descendants | place collection | Get all the descendants of a specific type under a place. |
| Create check-in claim | checkInClaim | Create a new checkInClaim object to record the check-in status for a specific place, such as a desk or a room, associated with a specific calendar reservation. |
Properties
| Property | Type | Description |
|---|---|---|
| address | physicalAddress | The physical address of the place, including the street, city, state, country or region, and postal code. |
| label | String | User-defined description of the place. |
| displayName | String | The name that is associated with the place. |
| geoCoordinates | outlookGeoCoordinates | Specifies the place location in latitude, longitude, and (optionally) altitude coordinates. |
| id | String | The unique identifier for the place. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. |
| isWheelChairAccessible | Boolean | Indicates whether the place is wheelchair accessible. |
| parentId | String | The ID of a parent place. |
| phone | String | The phone number of the place. |
| tags | String collection | Custom tags that are associated with the place for categorization or filtering. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| checkIns | checkInClaim collection | A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.place",
"address": {"@odata.type": "microsoft.graph.physicalAddress"},
"displayName": "String",
"geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
"id": "String (identifier)",
"isWheelChairAccessible": "Boolean",
"label": "String",
"parentId": "String",
"phone": "String",
"tags": ["String"]
}