获取位置

项目
07/24/2024

命名空间：microsoft.graph

获取由其 ID 或电子邮件地址指定的 place 对象的属性和关系。

place 对象可以是以下类型之一：

一个会议室，其中包含丰富的属性，例如会议室的电子邮件地址，以及辅助功能、容量和设备支持。
会议室列表，其中包含会议室列表的电子邮件地址，以及用于获取该会议室列表中会议室实例集合的导航属性。

room 和 roomList 都派生自 place 对象。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	Place.Read.All	不可用。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	Place.Read.All	不可用。

HTTP 请求

GET /places/{id}

可选的查询参数

使用 $select 获取特定的位置属性。

有关详细信息，请参阅 OData 查询参数。

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在响应正文中返回响应 200 OK 代码和请求的 place 对象。

示例

示例 1：获取会议室

请求

以下示例指定要获取其属性的聊天室的 ID。

HTTP
JavaScript

GET https://graph.microsoft.com/v1.0/places/979e9793-3e91-40eb-b18c-0ea937893956


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/979e9793-3e91-40eb-b18c-0ea937893956')
	.get();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.roomList",
    "id": "979e9793-3e91-40eb-b18c-0ea937893956",
    "displayName": "Building 2 Rooms",
    "address": null,
    "geoCoordinates": null,
    "phone": "",
    "emailAddress": "Building2Rooms@contoso.com"
}

示例 2：获取会议室列表

请求

以下示例指定 roomList 的 emailAddress 来获取其属性。

HTTP
JavaScript

GET https://graph.microsoft.com/v1.0/places/Building2Rooms@contoso.com


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/Building2Rooms@contoso.com')
	.get();