Edit

Share via


place resource type

Namespace: microsoft.graph

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.

Inherits from entity.

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

Working with the Places API in Microsoft Graph