通过

放置资源类型

  • 项目

命名空间：microsoft.graph

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

使用位置 API

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

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

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

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

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

方法

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

属性

属性 类型 说明
address physicalAddress 该地点的街道地址。
displayName String 与地点关联的名称。
geoCoordinates outlookGeoCoordinates 指定纬度、经度和 (位置（可选）) 高度坐标。
id String 地点的唯一标识符。 此为只读属性。 此标识符不可变，如果邮箱或租户配置发生更改，则此标识符可能会更改。 此 API 的 beta 版本添加了一个名为 placeId 的新属性，该属性提供不可变 ID。
phone String 地点的电话号码。

关系

无。

JSON 表示形式

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

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

相关内容