Тип ресурса place

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

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

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

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

Places, например room и 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	Уникальный идентификатор места. Только для чтения. Этот идентификатор не является неизменяемым и может измениться при внесении изменений в почтовый ящик или конфигурацию клиента. В бета-версии этого API добавлено новое свойство placeId, которое предоставляет неизменяемый идентификатор.
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 New-DistributionGroup.
• Чтобы администраторы добавили комнату в список помещений, используйте командлет Exchange PowerShell Add-DistributionGroupMember.