place 资源类型

命名空间：microsoft.graph

重要

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

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

使用位置 API

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

会议室 和 roomList等位置包含基本 id、显示名称 和电子邮件地址。 此外，它们包含导航信息（如物理地址和地理坐标）以及房间信息、其他相关信息（如 AV 功能、楼层和容量）。

findRooms 和 findRoomLists函数支持对租户中的会议室和会议室列表进行类似的查找。 下面是位置 API 和这些函数之间的比较。 如果要创建生产应用，请选择位置 API，因为 API 现已在 v1.0 中普遍提供。 计划更新使用 findRooms 或 findRoomLists 使用位置 API 的任何现有代码，因为 findRooms 或 findRoomLists 将弃用，并且将公布时间线。

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

方法

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

属性

属性	类型	说明
address	physicalAddress	位置的街道地址。
displayName	String	与位置关联的名称。
geoCoordinates	outlookGeoCoordinates	指定以纬度、经度和纬度（可选） (高度坐标) 位置。
id	String	位置的唯一标识符。 只读。
phone	String	位置的电话号码。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

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

另请参阅

• 若要使管理员创建会议室列表，请使用 Exchange PowerShell cmdlet New-DistributionGroup。
• 对于将会议室添加到会议室列表的管理员，请使用 Exchange Powershell cmdlet Add-DistributionGroupMember。