放置资源类型

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示基本位置属性，例如名称、物理地址和地理坐标。 此资源是更丰富的位置类型（例如 会议室、 工作区和 roomList）的基类型。

使用位置 API

Exchange Online管理员可以将租户中的会议室和工作区组织到会议室列表中。 使用位置 API，可以使用 列表 操作获取租户中的所有会议室、工作区或会议室列表，或获取特定会议室列表中的会议室和工作区。

会议室、工作区和 roomList 等Places包含基本 ID、显示名称和电子邮件地址。 此外，它们还包含导航信息（如物理地址和地理坐标），对于房间，还包含其他相关信息，例如 AV 功能、楼层号和容量。

findRooms 和 findRoomLists 函数支持对租户中的会议室和会议室列表进行类似的查找。 下表比较了 places API 和这些函数。

注意：findRooms 和 findRoomLists 函数已弃用。

Places API findRooms 和 findRoomLists 函数 (弃用)
获取租户中的所有会议室或会议室列表，以及会议室列表中的所有会议室。 获取租户中的所有会议室或会议室列表，以及会议室列表中的所有会议室。
列表位置 可以返回租户中的 100 多个会议室。 findRooms 最多返回租户中的前 100 个会议室。
支持在租户中 获取单个会议室或会议室列表 。 不支持获取租户中的单个会议室或会议室列表。
定义 room 和 roomList 的特定实体，这些实体指定更丰富的属性集、显示名称和 SMTP 地址。 每个会议室和会议室列表的权重较轻 的 emailAddress 类型，仅指定显示名称和 SMTP 地址。
仅支持具有委派 (工作或学校帐户) 或应用程序权限的组织方案。 仅支持具有委派权限或应用程序权限的组织方案。
支持更新租户中的 单个会议室或会议室列表 。 不支持更新租户中的单个会议室或会议室列表。

方法

方法 返回类型 说明
列出位置 所请求的派生类型的位置的集合 获取租户中定义的指定类型的 place 对象的集合。
获取位置 请求的派生位置类型 获取指定 位置 对象的属性和关系。
更新位置 请求的派生位置类型 更新指定 位置 对象的属性和关系。

属性

属性 类型 说明
address physicalAddress 该地点的街道地址。
displayName String 与地点关联的名称。
geoCoordinates outlookGeoCoordinates 指定纬度、经度和 (位置（可选）) 高度坐标。
id String 地点的唯一标识符。 此为只读属性。 此标识符不可变，如果邮箱或租户配置发生更改，则此标识符可能会更改。
phone String 地点的电话号码。
placeId String 地点的唯一不可变标识符。 此为只读属性。 此标识符的值等于从 cmdlet 返回的 Get-MailboxExternalDirectoryObjectId。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String",
  "placeId": "String (alternate identifier)"
}

相关内容