Place.Read.All

Allows the app to read your company's places (conference rooms and room lists) for calendar events and other applications, on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Place.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	913b9306-0ce1-42b8-9137-6a7df690a760	cb8f45a0-5c2e-4ea1-b803-84b870a7d7ec
DisplayText	Read all company places	Read all company places
Description	Allows the app to read company places (conference rooms and room lists) for calendar events and other applications, without a signed-in user.	Allows the app to read your company's places (conference rooms and room lists) for calendar events and other applications, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /places/{id}
	GET /places/microsoft.graph.room

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /places/{buildingPlaceId}/microsoft.graph.building/map
	GET /places/{buildingPlaceId}/microsoft.graph.building/map/footprints
	GET /places/{buildingPlaceId}/microsoft.graph.building/map/levels
	GET /places/{buildingPlaceId}/microsoft.graph.building/map/levels/{levelMapId}/fixtures
	GET /places/{buildingPlaceId}/microsoft.graph.building/map/levels/{levelMapId}/sections
	GET /places/{buildingPlaceId}/microsoft.graph.building/map/levels/{levelMapId}/units
	GET /places/{id}
	GET /places/{id}/descendants/{placeType}
	GET /places/{placeType}

	Commands
	Get-MgPlaceAsRoomListRoom

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaPlaceAsRoomListWorkspace
	Invoke-MgBetaDescendantPlace

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: building

Property	Type	Description
address	physicalAddress	The physical address of the building, including the street, city, state, country or region, and postal code. Inherited from place.
displayName	String	The name that is associated with the building. Inherited from place.
geoCoordinates	outlookGeoCoordinates	Specifies the building location in latitude, longitude, and (optionally) altitude coordinates. Inherited from place.
hasWiFi	Boolean	Indicates whether the building has a wireless network.
id	String	The unique identifier for the building. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from place.
isWheelChairAccessible	Boolean	Indicates whether the building is wheelchair accessible. Inherited from place.
label	String	User-defined description of the building. Inherited from place.
parentId	String	Currently, buildings don't have a parent. Don't use. Inherited from place.
phone	String	The phone number of the building. Inherited from place.
placeId	String	An alternate immutable unique identifier of the building. Read-only. Inherited from place.
resourceLinks	resourceLink collection	A set of links to external resources that are associated with the building. Inherited from place.
tags	String collection	Custom tags that are associated with the building for categorization or filtering. Inherited from place.

Graph reference: buildingMap

Property	Type	Description
id	String	Unique identifier for the buildingMapFeature object. Inherited from baseMapFeature.
placeId	String	Identifier for the building to which this buildingMap belongs.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **b

Graph reference: desk

Property	Type	Description
address	physicalAddress	The physical address of the desk, including the street, city, state, country or region, and postal code. Inherited from place.
displayDeviceName	String	The name of the display device (for example, `monitor` or `projector`) that is available at the desk.
displayName	String	The name that is associated with the desk. Inherited from place.
geoCoordinates	outlookGeoCoordinates	Specifies the desk location in latitude, longitude, and (optionally) altitude coordinates. Inherited from place.
id	String	The unique identifier for the desk. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from place.
isWheelChairAccessible	Boolean	Indicates whether the desk is wheelchair accessible. Inherited from place.
label	String	User-defined description of the desk. Inherited from place.
mailboxDetails	mailboxDetails	The mailbox object id and email address that are associated with the desk.
mode	placeMode	The mode of the desk. The supported modes are: assignedPlaceMode - Desks that are assigned to a user. reservablePlaceMode - Desks that can be booked in advance using desk reservation tools. dropInPlaceMode - First come, first served desks. When you plug into a peripheral on one of these desks, the desk is booked for you, assuming the peripheral is associated with the desk in the Microsoft Teams Rooms Pro management portal. offlinePlaceMode - Desk that is taken down for maintenance or marked as not reservable.
parentId	String	The ID of a parent section. Inherited from place.
phone	String	The phone number of the desk. Inherited from place.
placeId	String	An alternate immutable unique identifier of the desk. Read-only. Inherited from place.
tags	String collection	Custom tags that are associated with the **d

Graph reference: fixtureMap

Property	Type	Description
id	String	Unique identifier for the fixtureMap object. Inherited from baseMapFeature.
placeId	String	Identifier for the floor to which this fixtureMap belongs.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **f

Graph reference: floor

Property	Type	Description
address	physicalAddress	The physical address of the floor, including the street, city, state, country or region, and postal code. Inherited from place.
displayName	String	The name that is associated with the floor. Inherited from place.
geoCoordinates	outlookGeoCoordinates	Specifies the floor location in latitude, longitude, and (optionally) altitude coordinates. Inherited from place.
id	String	The unique identifier for the floor. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from place.
isWheelChairAccessible	Boolean	Indicates whether floor is wheelchair accessible. Inherited from place.
label	String	User-defined description of the floor. Inherited from place.
parentId	String	The ID of a parent building. Inherited from place.
phone	String	The phone number of the floor. Inherited from place.
placeId	String	An alternate immutable unique identifier of the floor. Read-only. Inherited from place.
sortOrder	Int32	Specifies the sort order of the floor. For example, a floor might be named "Lobby" with a sort order of `0` to show this floor first in ordered lists.
tags	String collection	Custom tags that are associated with the **f

Graph reference: footprintMap

Property	Type	Description
id	String	Unique identifier for the footprintMap object. Inherited from baseMapFeature.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **f

Graph reference: levelMap

Property	Type	Description
id	String	Unique identifier for the levelMap object. Inherited from baseMapFeature.
placeId	String	Identifier of the floor to which this levelMap belongs.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **l

Graph reference: place

Property	Type	Description
address	physicalAddress	The street address of the place.
displayName	String	The name associated with the place.
geoCoordinates	outlookGeoCoordinates	Specifies the place location in latitude, longitude, and (optionally) altitude coordinates.
id	String	A unique identifier for the place. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or the tenant configuration. The beta version of this API has a new property added called placeId, which provides an immutable ID.
phone	String	The phone number of the place.

Graph reference: room

Property	Type	Description
address	physicalAddress	The street address of the room.
audioDeviceName	String	Specifies the name of the audio device in the room.
bookingType	bookingType	Type of room. Possible values are `standard`, and `reserved`.
building	String	Specifies the building name or building number that the room is in.
capacity	Int32	Specifies the capacity of the room.
displayDeviceName	String	Specifies the name of the display device in the room.
displayName	String	The name associated with the room.
emailAddress	String	Email address of the room.
floorLabel	String	Specifies a descriptive label for the floor, for example, P.
floorNumber	Int32	Specifies the floor number that the room is on.
geoCoordinates	outlookGeoCoordinates	Specifies the room location in latitude, longitude, and optionally, altitude coordinates.
id	String	Unique identifier for the room. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or the tenant configuration. The beta version of this API has a new property added called placeId, which provides an immutable ID.
isWheelChairAccessible	Boolean	Specifies whether the room is wheelchair accessible.
label	String	Specifies a descriptive label for the room, for example, a number or name.
nickname	String	Specifies a nickname for the room, for example, "conf room".
phone	String	The phone number of the room.
tags	String collection	Specifies other features of the room, for example, details like the type of view or furniture type.
videoDeviceName	String	Specifies the name of the video device in the room.

Graph reference: roomList

Property	Type	Description
address	physicalAddress	The street address of the room list.
displayName	String	The name associated with the room list.
emailAddress	String	The email address of the room list.
geoCoordinates	outlookGeoCoordinates	Specifies the roomlist location in latitude, longitude, and (optionally) altitude coordinates.
id	String	Unique identifier for the room list. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or the tenant configuration. The beta version of this API has a new property added called placeId, which provides an immutable ID
phone	String	The phone number of the room list.

Graph reference: onenoteSection

Property	Type	Description
createdBy	identitySet	Identity of the user, device, and application which created the item. Read-only.
createdDateTime	DateTimeOffset	The date and time when the section was created. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.
displayName	String	The name of the section.
id	String	The unique identifier of the section. Read-only.
isDefault	Boolean	Indicates whether this is the user's default section. Read-only.
lastModifiedBy	identitySet	Identity of the user, device, and application which created the item. Read-only.
lastModifiedDateTime	DateTimeOffset	The date and time when the section was last modified. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.
links	SectionLinks	Links for opening the section. The `oneNoteClientURL` link opens the section in the OneNote native client if it's installed. The `oneNoteWebURL` link opens the section in OneNote on the web.
pagesUrl	String	The `pages` endpoint where you can get details for all the pages in the section. Read-only.
self	String	The endpoint where you can get details about the section. Read-only.

Graph reference: sectionMap

Property	Type	Description
id	String	Unique identifier for the sectionMap object. Inherited from baseMapFeature.
placeId	String	Identifier of the section to which this sectionMap belongs.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **s

Graph reference: unitMap

Property	Type	Description
id	String	Unique identifier for the unitMap object. Inherited from baseMapFeature.
placeId	String	Identifier of the place (such as a room) to which this unitMap belongs.
properties	String	Concatenated key-value pair of all properties of a GeoJSON file for this **u

Graph reference: workspace

Property	Type	Description
address	physicalAddress	The physical address of the workspace, including the street, city, state, country or region, and postal code. Inherited from place.
building	String	The name or identifier of the building where the workspace is located.
capacity	Int32	The maximum number of individual desks within a workspace.
displayDeviceName	String	The name of the display device (for example, `monitor` or `projector`) that is available in the workspace.
displayName	String	The name that is associated with the workspace. Inherited from place.
emailAddress	String	The email address that is associated with the workspace. This email address is used for booking.
floorLabel	String	A human-readable label for the floor; for example, `Ground Floor`.
floorNumber	Int32	The numeric floor level within the building. For example, `1` for first floor, `2` for second floor, and so on.
geoCoordinates	outlookGeoCoordinates	Specifies the workspace location in latitude, longitude, and (optionally) altitude coordinates. Inherited from place.
id	String	The unique identifier for the workspace. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from place.
isWheelChairAccessible	Boolean	Indicates whether the workspace is wheelchair accessible. Inherited from place.
label	String	User-defined description of the workspace. Inherited from place.
mode	placeMode	The mode for a workspace. The supported modes are: reservablePlaceMode - Workspaces that can be booked in advance using desk pool reservation tools. dropInPlaceMode - First come, first served desks. When you plug into a peripheral on one of these desks in the workspace, the desk is booked for you, assuming that the peripheral has been associated with the desk in the Microsoft Teams Rooms Pro management portal. offlinePlaceMode - Workspaces that are taken down for maintenance or marked as not reservable.
nickname	String	A short, friendly name for the workspace, often used for easier identification or display in the UI.
parentId	String	The ID of a parent section. Inherited from place.
phone	String	The phone number of the workspace. Inherited from place.
placeId	String	An alternate immutable unique identifier of the workspace. Read-only. Inherited from place.
tags	String collection	Custom tags that are associated with the **w

Table of Contents

Place.Read.All

Graph Methods

Resources