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