Получить место

Пространство имен: microsoft.graph

Чтение свойств объекта place , указанного его идентификатором.

Объект place может быть одного из следующих типов:

Здание, которое включает в себя расширенные свойства, такие как ссылки на ресурсы, и имеет беспроводную сеть.
Пол, который включает в себя расширенные свойства, такие как порядок сортировки.
Раздел.
Рабочий стол, который включает в себя расширенные свойства, такие как сведения о почтовом ящике и режим.
Комната, которая включает в себя расширенные свойства, такие как адрес электронной почты для комнаты, а также специальные возможности, емкость и поддержку устройств.
Рабочая область, которая включает такие свойства, как адрес электронной почты для рабочей области, а также специальные возможности и емкость.
Объект roomList, включающий адрес электронной почты для списка комнат и свойство навигации для получения коллекции экземпляров комнат в этом списке комнат.

Перечисленные ресурсы являются производными от объекта place .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	Place.Read.All	Place.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	Place.Read.All	Place.ReadWrite.All

HTTP-запрос

GET /places/{id}

Необязательные параметры запросов

Этот метод поддерживает $select параметр запроса для получения определенных свойств. Общие сведения см. в статье Параметры запроса OData.

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект place в тексте отклика.

Примеры

Пример 1. Получение здания

В следующем примере показан запрос на получение здания.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/ca147fcf-ae27-43bb-9d91-f11e626e58bf

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/ca147fcf-ae27-43bb-9d91-f11e626e58bf')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.building",
  "id": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "placeId": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "displayName": "B06",
  "phone": "+1 (425) 615 8888 Ext 06",
  "isWheelChairAccessible": true,
  "label": "This is a building for demo",
  "hasWiFi": true,
  "geoCoordinates": {
    "latitude": 47.644125,
    "longitude": -122.122411,
    "accuracy": null,
    "altitude": null,
    "altitudeAccuracy": null
  },
  "resourceLinks": [
    {
      "name": "Microsoft Web",
      "linkType": "url",
      "value": "www.microsoft.com"
    }
  ]
}

Пример 2. Получение пола

В следующем примере показан запрос на получение этажа.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/49558ad4-6ede-46d7-8254-3ca9f90fc4e2

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/49558ad4-6ede-46d7-8254-3ca9f90fc4e2')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.floor",
  "id": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2",
  "placeId": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2",
  "displayName": "3",
  "parentId": "ca147fcf-ae27-43bb-9d91-f11e626e58bf",
  "sortOrder": 3
}

Пример 3. Получение раздела

В следующем примере показан запрос на получение раздела.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/ca163ae1-14a3-4e2a-8a97-5f82d672186f

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/ca163ae1-14a3-4e2a-8a97-5f82d672186f')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.section",
  "id": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "placeId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "displayName": "Mode Section 1",
  "parentId": "49558ad4-6ede-46d7-8254-3ca9f90fc4e2"
}

Пример 4. Получение стола

В следующем примере показан запрос на получение стола.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/df7dd4ef-04c4-41dd-816e-35475f4dd546

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/df7dd4ef-04c4-41dd-816e-35475f4dd546')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.desk",
  "id": "df7dd4ef-04c4-41dd-816e-35475f4dd546",
  "placeId": "df7dd4ef-04c4-41dd-816e-35475f4dd546",
  "displayName": "Desk6",
  "parentId": "ca163ae1-14a3-4e2a-8a97-5f82d672186f",
  "mode": { "@odata.type": "#microsoft.graph.dropInPlaceMode" }
}

Пример 5. Получение комнаты

В следующем примере показан запрос на получение комнаты.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/0be387a4-d53b-410f-9daf-f4fa07e5b05a

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/0be387a4-d53b-410f-9daf-f4fa07e5b05a')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.room",
  "id": "0be387a4-d53b-410f-9daf-f4fa07e5b05a",
  "placeId": "4923e5a8-453e-4edf-b272-9c33757d4fb3",
  "displayName": "TestRoom-123",
  "parentId": "88d25c73-e9c2-4284-86d7-2cf5685b67b9",
  "isWheelChairAccessible": true,
  "emailAddress": "TestRoom-123@contoso.com",
  "nickname": "TestRoomZihan-123",
  "bookingType": "standard",
  "isTeamsEnabled": true
}

Пример 6. Получение рабочей области

В следующем примере показан запрос на получение рабочей области.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/ec10ce32-2065-40ba-aa2f-ecd5ea175420

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let place = await client.api('/places/ec10ce32-2065-40ba-aa2f-ecd5ea175420')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже показан пример отклика.

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

{
  "@odata.type": "#microsoft.graph.workspace",
  "id": "ec10ce32-2065-40ba-aa2f-ecd5ea175420",
  "placeId": "8abb4849-b6a0-4c45-baab-92a6b63227a5",
  "displayName": "deskpool 003",
  "parentId": "46e0d2ec-d026-4e1d-861d-80ede4470f67",
  "emailAddress": "deskpool0039052bd811752731134695@contoso.com",
  "nickname": "deskpool 003",
  "capacity": 10
}

Пример 7. Получение списка помещений

В следующем примере показан запрос на получение roomList.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Places["{place-id}"].GraphRoomList.GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphRoomList, err := graphClient.Places().ByPlaceId("place-id").GraphRoomList().Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

RoomList result = graphClient.places().byPlaceId("{place-id}").graphRoomList().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let roomList = await client.api('/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->places()->byPlaceId('place-id')->graphRoomList()->get()->wait();


Import-Module Microsoft.Graph.Calendar

Get-MgPlaceAsRoomList -PlaceId $placeId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.places.by_place_id('place-id').graph_room_list.get()

Отклик

Ниже показан пример отклика.

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

{
  "id": "dc404124-302a-92aa-f98d-7b4deb0c1705",
  "displayName": "Building 1",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "emailAddress": "bldg1@contoso.com",
  "placeId": "406bd1b2-237c-4710-bda2-8b7900d61b27"
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-04-01

Получить место

Разрешения

HTTP-запрос

Необязательные параметры запросов

Заголовки запросов

Текст запроса

Отклик

Примеры

Пример 1. Получение здания

Запрос

Отклик

Пример 2. Получение пола

Запрос

Отклик

Пример 3. Получение раздела

Запрос

Отклик

Пример 4. Получение стола

Запрос

Отклик

Пример 5. Получение комнаты

Запрос

Отклик

Пример 6. Получение рабочей области

Запрос

Отклик

Пример 7. Получение списка помещений

Запрос

Отклик

Обратная связь

Дополнительные ресурсы