Тип ресурса 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.