放置资源类型

命名空间:microsoft.graph

表示基本位置属性,例如名称、物理地址和地理坐标。 这是更丰富的位置类型的基类型,如 roomroomList

使用位置 API

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

会议室会议室列表等位置包含基本 ID、显示名称和电子邮件地址。 此外,它们还包含导航信息,如物理地址和地理坐标,以及房间中的其他相关信息,如 AV 功能、楼层数和容量。

findRoomsfindRoomLists 函数支持对租户中的会议室和会议室列表进行类似的查找。 下面是位置 API 与这些函数之间的比较。 如果要创建生产应用,请选择 API 的位置,因为 API 现已在 v1.0 中正式发布。 计划更新使用 findRoomsfindRoomLists 来使用位置 API 的任何现有代码,因为 findRoomsfindRoomLists 将被弃用,并且将宣布一个时间线。

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

方法

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

属性

属性 类型 说明
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"
}

另请参阅