放置资源类型
命名空间:microsoft.graph
表示基本位置属性,例如名称、物理地址和地理坐标。 这是更丰富的位置类型的基类型,如 room 和 roomList。
使用位置 API
Exchange Online管理员可以将租户中的会议室组织到会议室列表中。 使用位置 API,可以获取租户中的所有会议室列表或会议室,或获取特定会议室列表中的所有会议室。
会议室和 会议室列表等位置包含基本 ID、显示名称和电子邮件地址。 此外,它们还包含导航信息,如物理地址和地理坐标,以及房间中的其他相关信息,如 AV 功能、楼层数和容量。
findRooms 和 findRoomLists 函数支持对租户中的会议室和会议室列表进行类似的查找。 下面是位置 API 与这些函数之间的比较。 如果要创建生产应用,请选择 API 的位置,因为 API 现已在 v1.0 中正式发布。 计划更新使用 findRooms 或 findRoomLists 来使用位置 API 的任何现有代码,因为 findRooms 或 findRoomLists 将被弃用,并且将宣布一个时间线。
| 放置 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"
}
另请参阅
- 若要让管理员创建会议室列表,请使用 Exchange PowerShell cmdlet New-DistributionGroup。
- 若要让管理员将会议室添加到会议室列表,请使用 Exchange Powershell cmdlet Add-DistributionGroupMember。
反馈
提交和查看相关反馈