Тип ресурса place

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет базовые атрибуты расположения, такие как имя, физический адрес и географические координаты. Этот ресурс является базовым типом для расширенных типов расположения, таких как комната, рабочая область и список помещений.

Использование API мест

Exchange Online администраторы могут упорядочивать комнаты для собраний и рабочие области в клиенте по спискам помещений. С помощью API мест можно использовать операцию со списком для получения всех комнат, рабочих областей или списков комнат в клиенте или получения комнат и рабочих областей в определенном списке помещений.

Places, такие как room, workspace и roomList, содержат базовый идентификатор, отображаемое имя и адрес электронной почты. Кроме того, они содержат навигационную информацию, например физический адрес и географические координаты, а в случае комнат — другую важную информацию, например возможности av, номер этажа и емкость.

Функции findRooms и findRoomLists поддерживают аналогичные подстановки для комнат и списков комнат в клиенте. В следующей таблице сравнивается API мест и эти функции.

Примечание: Функции findRooms и findRoomLists устарели.

API Places	функции findRooms и findRoomLists (не рекомендуется)
Возвращает все комнаты или списки комнат в арендаторе и все комнаты в списке комнат.	Возвращает все комнаты или списки комнат в арендаторе и все комнаты в списке комнат.
Список мест может вернуть более 100 комнат в клиенте.	Функция findRooms возвращает до первых 100 комнат в клиенте.
Поддерживает получение отдельной комнаты или списка комнат в клиенте.	Не поддерживает получение отдельной комнаты или списка комнат в клиенте.
Определяет конкретные сущности room и roomList , которые указывают более широкий набор свойств, отображаемое имя и SMTP-адрес.	Каждый список комнат и помещений имеет меньший тип электронной почтыAddress , в котором указываются только отображаемое имя и SMTP-адрес.
Поддерживает только организационные сценарии с делегированными (рабочие или учебные учетные записи) или разрешениями приложений.	Поддерживает только организационные сценарии с делегированными разрешениями или разрешениями приложения.
Поддерживает обновление отдельной комнаты или списка комнат в клиенте.	Не поддерживает обновление отдельной комнаты или списка комнат в клиенте.

Методы

Метод	Возвращаемый тип	Описание
Список мест	Коллекция запрошенного производного типа места	Получение коллекции указанного типа объектов place , определенных в клиенте.
Получить место	Запрошенный производный тип места	Получение свойств и связей указанного объекта place .
Место обновления	Запрошенный производный тип места	Обновление свойств и связей указанного объекта place .

Свойства

Свойство	Тип	Описание
address	physicalAddress	Адрес улицы места.
displayName	String	Имя, связанное с местом.
geoCoordinates	outlookGeoCoordinates	Указывает расположение места в координатах широты, долготы и (при необходимости) высоты.
id	String	Уникальный идентификатор места. Только для чтения. Этот идентификатор не является неизменяемым и может измениться при изменении почтового ящика или конфигурации клиента.
phone	String	Номер телефона места.
placeId	String	Уникальный, неизменяемый идентификатор места. Только для чтения. Значение этого идентификатора равно ExternalDirectoryObjectId , возвращенное командлетом Get-Mailbox .

Связи

Отсутствуют.

Представление JSON

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

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

Связанные материалы

• Чтобы администраторы создали список помещений, используйте командлет Exchange PowerShell New-DistributionGroup.
• Чтобы администраторы добавили комнату в список помещений, используйте командлет Exchange PowerShell Add-DistributionGroupMember.