user: findRooms

  • Статья

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

Важно!

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

Получение объектов emailAddress, представляющих все помещения для собраний в клиенте пользователя или определенном списке помещений.

Клиенты могут упорядочивать помещения для собраний в списках помещений. В этом API каждое помещение для собрания и список помещений представлены экземпляром emailAddress. Можно получить все списки помещений в клиенте, получить все помещения в клиенте или получить все помещения в определенном списке помещений. Можно получить до 100 первых помещений в клиенте.

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

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

Разрешения

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

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

HTTP-запрос

Получение всех помещений в клиенте:

GET /me/findRooms
GET /users/{id}/findRooms

Получение всех помещений в определенном списке помещений клиента:

GET /me/findRooms(RoomList='{room_list_emailAddress}')
GET /users/{id}/findRooms(RoomList='{room_list_emailAddress}')

Параметры запроса

Параметр запроса Тип Описание
RoomList string SMTP-адрес, связанный со списком помещений. Каждый список помещений представлен экземпляром emailAddress, включающим SMTP-адрес.

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

Имя Тип Описание
Authorization string Bearer {token}. Обязательно.
Content-Type string application/json. Обязательно.

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

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

Отклик

При успешном выполнении этот метод возвращает код отклика 200 OK и коллекцию объектов emailAddress в тексте отклика.

Примеры

Пример 1. Получение всех адресов электронной почты пользователем, выполнившего вход

Запрос

Ниже приведен пример, который получает объекты emailAddress , представляющие все комнаты, определенные в клиенте вошедшего пользователя.

GET https://graph.microsoft.com/beta/me/findRooms

Отклик

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

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.emailAddress)",
    "value": [
        {
            "name": "Conf Room Adams",
            "address": "Adams@contoso.com"
        },
        {
            "name": "Conf Room Baker",
            "address": "Baker@contoso.com"
        },
        {
            "name": "Conf Room Crystal",
            "address": "Crystal@contoso.com"
        },
        {
            "name": "Conf Room Hood",
            "address": "Hood@contoso.com"
        },
        {
            "name": "Conf Room Rainier",
            "address": "Rainier@contoso.com"
        },
        {
            "name": "Conf Room Stevens",
            "address": "Stevens@contoso.com"
        }
    ]
}

Пример 2. Получение всех адресов электронной почты по указанному списку помещений

Запрос

Во втором примере возвращаются объекты emailAddress , представляющие комнаты в указанном списке комнат, определяемом адресом Building2Rooms@contoso.comэлектронной почты .

GET https://graph.microsoft.com/beta/me/findRooms(RoomList='Building2Rooms@contoso.com')

Отклик

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

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.emailAddress)",
    "value": [
        {
            "name": "Conf Room Baker",
            "address": "Baker@contoso.com"
        },
        {
            "name": "Conf Room Hood",
            "address": "Hood@contoso.com"
        },
        {
            "name": "Conf Room Rainier",
            "address": "Rainier@contoso.com"
        }
    ]
}