Edytuj

place resource type

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 places place collection Get a collection of the specified type of place objects defined in a tenant.
Create place place Create a new place object.
Get place place Read the properties of a place object. Returns the requested, derived type of place.
Update place place Update the properties of place object that can be a building, floor, section, desk, room, workspace, or roomList.
Delete place None Delete a place object.
List 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, room, or workspace, associated with a specific calendar reservation.
Upsert places Location header Upsert one or more place objects in async mode.
Get operation placeOperation Get a placeOperation by ID.
List operations placeOperation collection List all existing placeOperation objects.

Properties

Property Type Description
address physicalAddress The physical address of the place, including the street, city, state, country or region, and postal code.
customProperties stringDictionary Custom properties for the place. Each property has a string key and a string value. Nullable.
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.
label String User-defined description of the place.
lastUpdatedTime DateTimeOffset The date and time when the place was last updated. The timestamp is in ISO 8601 format and is always in UTC. Read-only. Nullable.
parentId String The ID of a parent place.
phone String The phone number of the place.
placeId String A stable service-level identifier for the place object used by Places workloads.
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.
children place collection A collection of children places that is only used in the Upsert places API.

JSON representation

The following JSON representation shows the resource type.

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

Related content

Working with the Places API in Microsoft Graph

  • Last updated on