Table of contents
TOC
Свернуть оглавление
Развернуть оглавление
Последнее обновление: 29.06.2018

Справочник по API-интерфейсу Outlook (Предварительная версия)

Эта документация охватывает API Люди, который находится в режиме предварительной версии. Параметры предварительной версии могут быть изменены до завершения и могут нарушать код, который их использует. Поэтому в своем производственном коде вы должны использовать только производственную версию API. Если она доступна, предпочтительной версией в настоящее время является v2.0.

API Люди Outlook позволяет вам получать информацию о людях, которые важны для вас из-за почты, контактов и социальных сетей. Вы можете комбинировать информацию о человеке из многих источников в едином запросе к единой конечной точке. Вы можете использовать API для доступа к информации, защищенной Azure Active Directory в Office 365. Он также предоставляет доступ к учетным записям Microsoft в этих доменах: office.com, hotmail.com, live.com и office365.com.

Заметка Эта статья относится ко всем поддерживаемым доменам одинаковым образом. Для простоты в остальной части этой статьи используется «outlook.office.com», чтобы ссылаться на учетные записи во всех доменах.

Все операции API Люди

API Люди возвращает релевантную персону объектов с каждым запросом. Объект person позволяет вам получать информацию о людях, которые важны для вас из-за почты, контактов и социальных сетей. Результаты упорядочены по релевантности, которая определяется критериями, указанными в запросе, и оценивается на основе множественных связей, сотрудничества и деловых отношений.

Просмотр списка людей | Получить список людей, использующих поиск

Использование API REST Люди

Проверка подлинности

Как и для других API REST Outlook, для каждого запроса к API Outlook необходимо включать допустимый маркер доступа. Вы должны зарегистрироваться и определить свое приложение и получить соответствующее разрешение, чтобы получить маркер доступа. Вы можетеузнать больше о некоторых упрощенных параметрах регистрации и авторизации.

Поддерживаемые действия REST и конечные точки

Чтобы взаимодействовать с API REST Люди, вы отправляете HTTP-запросы GET на поддерживаемую конечную точку.

Имена ресурсов URL-адреса пути и параметры запроса нечувствительны к регистру; однако присваиваемые значения, идентификаторы объектов и значения, кодированные base64, чувствительны к регистру.

Во всех запросах API REST Люди используется следующий корневой URL-формат.

https://outlook.office.com/api/{version}/{user context}

Версия API

{version} представляет версию API REST в указанном корневом URL-адресе. Единственная версия, которую вы можете указать, это beta.

  • betaЭта версия находится в состоянии предварительной и не должна использоваться в рабочем коде. Пример URL: https://outlook.office.com/api/beta/me/people. Эта версия включает новейший API в GA, а также дополнительные наборы API, которые находятся в режиме предварительной версии, и которые могут измениться до завершения.

Целевой пользователь

{user_context} текущий пользователь; API Люди выполняет все запросы от имени текущего пользователя. Вы можете указать пользовательский контекст в Запросах REST следующим образом.

  • С помощью me ярлыка: /api/{version}/me. Корневой URL-адрес становится https://outlook.office.com/api/{version}/me.

В ответах сервера_пользовательский контекст идентифицируется_в этом формате: users/{AAD_userId@AAD_tenantId}.

Просмотр людей

Отправка ответа | Сортировка ответа | Установка количества людей в ответе | Выбор возвращаемых полей | Фильтрация ответа | Фильтрация и выбор возвращаемых полей

Требуемый объем: https://outlook.office.com/people.read

Следующий запрос получает людей, наиболее релевантных пользователю, на основе связей, сотрудничества и деловых отношений. По умолчанию каждый ответ возвращает 10 записей, но вы можете изменить это используя параметр $top.

https://outlook.office.com/api/beta/me/people/

Ответ на запрос следующий.

    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMPSuxK9KrREk1tt36xsca8=')",
          "Id": "AAUQAMPSuxK9KrREk1tt36xsca8=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Stuart Bui",
          "GivenName": "Stuart",
          "Surname": "Bui",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "sbui@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMLasTGasi1NmGqss0adMLI=')",
          "Id": "AAUQAMLasTGasi1NmGqss0adMLI=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Phillip Wooley",
          "GivenName": "Phillip",
          "Surname": "Wooley",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "phillipw@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACfUjORcHM1Juw-lAPzHFIk=')",
          "Id": "AAUQACfUjORcHM1Juw-lAPzHFIk=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Nestor Kellum",
          "GivenName": "Nestor",
          "Surname": "Kellum",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "nestork@contoso.com"
            },
             {
              "Address": "nestork@hotmail.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQADSJ952xczZGkD0tsvxPomg=')",
          "Id": "AAUQADSJ952xczZGkD0tsvxPomg=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Lacey Burns",
          "GivenName": "Lacey",
          "Surname": "Burns",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "laceyb@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMJuQ5gE3IdFl1lpkykoJeY=')",
          "Id": "AAUQAMJuQ5gE3IdFl1lpkykoJeY=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Ralph Foret",
          "GivenName": "Ralph",
          "Surname": "Foret",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "ralphf@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMrt5YwDXhJIlWoRZX9ebnw=')",
          "Id": "AAUQAMrt5YwDXhJIlWoRZX9ebnw=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Emery Hixson",
          "GivenName": "Emery",
          "Surname": "Hixson",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "emeryh@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAOFizzhIt3ZCh4pW33s_iOQ=')",
          "Id": "AAUQAOFizzhIt3ZCh4pW33s_iOQ=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Stephanie Ray",
          "GivenName": "Stephanie",
          "Surname": "Ray",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "stephanier@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 12"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKirlq5lgdFHuhZ8O9FI8XA=')",
          "Id": "AAUQAKirlq5lgdFHuhZ8O9FI8XA=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Natalie Roach",
          "GivenName": "Natalie",
          "Surname": "Roach",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "natalier@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKAXFd--O4lGr6RNJzbBXwE=')",
          "Id": "AAUQAKAXFd--O4lGr6RNJzbBXwE=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Ignacio Slayton",
          "GivenName": "Ignacio",
          "Surname": "Slayton",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "ignacios@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 3"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAAxHEg0Rus9CmXr0FE4muco=')",
          "Id": "AAUQAAxHEg0Rus9CmXr0FE4muco=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Clayton Flanigan",
          "GivenName": "Clayton",
          "Surname": "Flanigan",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "claytonf@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24top=10&%24skip=10"
    }

Запрос следующей страницы людей

Если первый ответ не содержит полного списка релевантных людей, вы можете сделать второй запрос, используя $top а также запрос $skip, чтобы запрашивать дополнительные страницы информации. Если предыдущий запрос имеет дополнительную информацию, следующий запрос получает следующую страницу людей с сервера.

https://outlook.office.com/api/beta/me/people/?$top=10&$skip=10

Ниже приведен ответ от сервера.

    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQADrqbKGdhxdNkjXAVQHEvMQ=')",
          "Id": "AAUQADrqbKGdhxdNkjXAVQHEvMQ=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Monte Lafferty",
          "GivenName": "Monte",
          "Surname": "Lafferty",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "montel@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAHiSySeJLAtAo6t0FuPmns0=')",
          "Id": "AAUQAHiSySeJLAtAo6t0FuPmns0=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Madelyn Cooley",
          "GivenName": "Madelyn",
          "Surname": "Cooley",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "madelync@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 11"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACQ-gdlH_4hPvR5o7cUkm7A=')",
          "Id": "AAUQACQ-gdlH_4hPvR5o7cUkm7A=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Leo Scholl",
          "GivenName": "Leo",
          "Surname": "Scholl",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "leos@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAHc2322QSPBJtxkeVUcXPGs=')",
          "Id": "AAUQAHc2322QSPBJtxkeVUcXPGs=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Lucinda Burke",
          "GivenName": "Lucinda",
          "Surname": "Burke",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "shoebm@exchange.contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAEld1zm_6W9Covp5NAGvszw=')",
          "Id": "AAUQAEld1zm_6W9Covp5NAGvszw=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Ernesto Fellows",
          "GivenName": "Ernesto",
          "Surname": "Fellows",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "ernestof@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACgDLi02r8RDmtK-40rUPXE=')",
          "Id": "AAUQACgDLi02r8RDmtK-40rUPXE=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Margret Nash",
          "GivenName": "Margret",
          "Surname": "Nash",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "margretn@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKXZsceAVjRDiUASCswoQxY=')",
          "Id": "AAUQAKXZsceAVjRDiUASCswoQxY=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Wendy Monroe",
          "GivenName": "Wendy",
          "Surname": "Monroe",
          "Title": "ARCHITECT",
          "EmailAddresses": [
            {
              "Address": "wendym@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAO-ckLra2wFBjbgc1-F5yyQ=')",
          "Id": "AAUQAO-ckLra2wFBjbgc1-F5yyQ=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Alberta Johns",
          "GivenName": "Alberta",
          "Surname": "Johns",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "albertaj@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAO-Giffc5HxMibij3YNPuvU=')",
          "Id": "AAUQAO-Giffc5HxMibij3YNPuvU=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Leticia Bullock",
          "GivenName": "Leticia",
          "Surname": "Bullock",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "leticiab@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAE6BF792ae9KoMQeDZbxDK0=')",
          "Id": "AAUQAE6BF792ae9KoMQeDZbxDK0=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Angelita Dillard",
          "GivenName": "Angelita",
          "Surname": "Dillard",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "angelitad@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 3"
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24skip=20&%24top=10"
    }

Сортировка в отклике

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

https://outlook.office.com/api/beta/me/people/?$orderby=DisplayName 

Ниже приведен ответ от сервера.

      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
      "value": [
        {
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAO46ZoZRt65Ajfvu2d8atiw=')",
          "Id": "AAUQAO46ZoZRt65Ajfvu2d8atiw=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Angelina Blackwell",
          "GivenName": "Angelina",
          "Surname": "Blackwell",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "angelinab@exchange.contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 5"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAGaI4BZyQURDtuk0nNvBYGk=')",
          "Id": "AAUQAGaI4BZyQURDtuk0nNvBYGk=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Benita Wilkerson",
          "GivenName": "Benita",
          "Surname": "Wilkerson",
          "Title": "RESEARCHER",
          "EmailAddresses": [
            {
              "Address": "benitaw@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building C"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKOPqJuLWk9NtmwOx29rbew=')",
          "Id": "AAUQAKOPqJuLWk9NtmwOx29rbew=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Callie Sweet",
          "GivenName": "Callie",
          "Surname": "Sweet",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "callies@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 2"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxMjF2cmVxdWVzdC5zdXBwb3J0QG9lLjIxdmlhbmV0LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxMjF2cmVxdWVzdC5zdXBwb3J0QG9lLjIxdmlhbmV0LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "contoso.support",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "contoso.support@outlook.office.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACtCaoUN6WdNgpyCSeKSP6E=')",
          "Id": "AAUQACtCaoUN6WdNgpyCSeKSP6E=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Dianne Frederick",
          "GivenName": "Dianne",
          "Surname": "Frederick",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "diannef@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 3"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKNvearlKU1PsHmDb-xmDrQ=')",
          "Id": "AAUQAKNvearlKU1PsHmDb-xmDrQ=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Jenifer Dotson",
          "GivenName": "Jenifer",
          "Surname": "Dotson",
          "Title": "SENENGINEER",
          "EmailAddresses": [
            {
              "Address": "jeniferd@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAAVBb0xn3ctFiZreqwDwZf0=')",
          "Id": "AAUQAAVBb0xn3ctFiZreqwDwZf0=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Nancy Washington",
          "GivenName": "Nancy",
          "Surname": "Washington",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "nancyw@exchange.contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 3"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKirlq5lgdFHuhZ8O9FI8XA=')",
          "Id": "AAUQAKirlq5lgdFHuhZ8O9FI8XA=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Natalie Roach",
          "GivenName": "Natalie",
          "Surname": "Roach",
          "Title": "LEAD",
          "EmailAddresses": [
            {
              "Address": "natalier@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKVYmyKcnQ9Njw5bvInrWYI=')",
          "Id": "AAUQAKVYmyKcnQ9Njw5bvInrWYI=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Natalie Roach's Team",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "ntteam@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAFcMhzA6m4pBlHmc3Qa_PpA=')",
          "Id": "AAUQAFcMhzA6m4pBlHmc3Qa_PpA=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Queen Duncan",
          "GivenName": "Queen",
          "Surname": "Duncan",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "queend@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 3"
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24orderby=DisplayName&%24top=10&%24skip=10"
    }

Изменение количества возвращенных людей и возвращенных полей

Вы можете изменить количество людей, возвращаемых в отклике, настроив параметр $top.

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

https://outlook.office.com/api/beta/me/people/?$top=1000&$Select=DisplayName

Ниже приведен ответ от сервера.

    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People(DisplayName)",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMPSuxK9KrREk1tt36xsca8=')",
          "Id": "AAUQAMPSuxK9KrREk1tt36xsca8=",
          "DisplayName": "Brian Remick"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMLasTGasi1NmGqss0adMLI=')",
          "Id": "AAUQAMLasTGasi1NmGqss0adMLI=",
          "DisplayName": "Phillip Wooley"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACfUjORcHM1Juw-lAPzHFIk=')",
          "Id": "AAUQACfUjORcHM1Juw-lAPzHFIk=",
          "DisplayName": "Nestor Kellum"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQADSJ952xczZGkD0tsvxPomg=')",
          "Id": "AAUQADSJ952xczZGkD0tsvxPomg=",
          "DisplayName": "Lacey Burns"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMJuQ5gE3IdFl1lpkykoJeY=')",
          "Id": "AAUQAMJuQ5gE3IdFl1lpkykoJeY=",
          "DisplayName": "Ralph Foret"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMrt5YwDXhJIlWoRZX9ebnw=')",
          "Id": "AAUQAMrt5YwDXhJIlWoRZX9ebnw=",
          "DisplayName": "Emery Hixson"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAOFizzhIt3ZCh4pW33s_iOQ=')",
          "Id": "AAUQAOFizzhIt3ZCh4pW33s_iOQ=",
          "DisplayName": "Stephanie Ray"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKirlq5lgdFHuhZ8O9FI8XA=')",
          "Id": "AAUQAKirlq5lgdFHuhZ8O9FI8XA=",
          "DisplayName": "Natalie Roach"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKAXFd--O4lGr6RNJzbBXwE=')",
          "Id": "AAUQAKAXFd--O4lGr6RNJzbBXwE=",
          "DisplayName": "Ignacio Slayton"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAAxHEg0Rus9CmXr0FE4muco=')",
          "Id": "AAUQAAxHEg0Rus9CmXr0FE4muco=",
          "DisplayName": "Clayton Flanigan"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQADrqbKGdhxdNkjXAVQHEvMQ=')",
          "Id": "AAUQADrqbKGdhxdNkjXAVQHEvMQ=",
          "DisplayName": "Monte Lafferty"
        },
        ... etc

Выбор полей для возврата

Вы можете ограничить объем данных, возвращаемых с сервера, выбрав одно или несколько полей с помощью параметра $select_для выбора одного или нескольких полей. Поле @ odata.id_ всегда возвращается.

В примере ниже показано, как ограничить перечень полей, возвращаемых в отклике, полями DisplayName и EmailAddress для 10 наиболее релевантных людей.

https://outlook.office.com/api/beta/me/people/?$select=DisplayName,EmailAddresses

Ниже приведен ответ от сервера.

    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People(DisplayName,EmailAddresses)",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMPSuxK9KrREk1tt36xsca8=')",
          "Id": "AAUQAMPSuxK9KrREk1tt36xsca8=",
          "DisplayName": "Brian Remick",
          "EmailAddresses": [
            {
              "Address": "bremick@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMLasTGasi1NmGqss0adMLI=')",
          "Id": "AAUQAMLasTGasi1NmGqss0adMLI=",
          "DisplayName": "Phillip Wooley",
          "EmailAddresses": [
            {
              "Address": "phillipw@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACfUjORcHM1Juw-lAPzHFIk=')",
          "Id": "AAUQACfUjORcHM1Juw-lAPzHFIk=",
          "DisplayName": "Nestor Kellum",
          "EmailAddresses": [
            {
              "Address": "nestork@contoso.com"
            },
             {
              "Address": "nestork@outlook.office.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQADSJ952xczZGkD0tsvxPomg=')",
          "Id": "AAUQADSJ952xczZGkD0tsvxPomg=",
          "DisplayName": "Lacey Burns",
          "EmailAddresses": [
            {
              "Address": "laceyb@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMJuQ5gE3IdFl1lpkykoJeY=')",
          "Id": "AAUQAMJuQ5gE3IdFl1lpkykoJeY=",
          "DisplayName": "Ralph Foret",
          "EmailAddresses": [
            {
              "Address": "ralphf@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMrt5YwDXhJIlWoRZX9ebnw=')",
          "Id": "AAUQAMrt5YwDXhJIlWoRZX9ebnw=",
          "DisplayName": "Emery Hixson",
          "EmailAddresses": [
            {
              "Address": "emeryh@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAOFizzhIt3ZCh4pW33s_iOQ=')",
          "Id": "AAUQAOFizzhIt3ZCh4pW33s_iOQ=",
          "DisplayName": "Stephanie Ray",
          "EmailAddresses": [
            {
              "Address": "stephanier@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKirlq5lgdFHuhZ8O9FI8XA=')",
          "Id": "AAUQAKirlq5lgdFHuhZ8O9FI8XA=",
          "DisplayName": "Natalie Roach",
          "EmailAddresses": [
            {
              "Address": "natalier@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAKAXFd--O4lGr6RNJzbBXwE=')",
          "Id": "AAUQAKAXFd--O4lGr6RNJzbBXwE=",
          "DisplayName": "Ignacio Slayton",
          "EmailAddresses": [
            {
              "Address": "ignacios@contoso.com"
            }
          ]
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAAxHEg0Rus9CmXr0FE4muco=')",
          "Id": "AAUQAAxHEg0Rus9CmXr0FE4muco=",
          "DisplayName": "Clayton Flanigan",
          "EmailAddresses": [
            {
              "Address": "claytonf@contoso.com"
            }
          ]
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24select=DisplayName%2cEmailAddresses&%24top=10&%24skip=10"
    }

Использование фильтра для ограничения ответа

Вы можете использовать параметр $filter, чтобы ограничить количество информации в отклике и возвращать только тех людей, записи которых содержат указанные критерии.

Следующий запрос ограничивает ответ людям с источником «История сообщений».

https://outlook.office.com/api/beta/me/people/?$Filter=Sources/Any (source: source/Type  eq 'Communications History') 
    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxcGVvcGxlcmVsZXZhbmNlQHNlcnZpY2UuZXhjaGFuZ2UubWljcm9zb2Z0LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxcGVvcGxlcmVsZXZhbmNlQHNlcnZpY2UuZXhjaGFuZ2UubWljcm9zb2Z0LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "People Relevance",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "peoplerelevance@service.exchange.contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxcmNoaUByY2hpbGF3LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxcmNoaUByY2hpbGF3LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "Edna Dickson",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "ednad@outlook.office.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxMjF2cmVxdWVzdC5zdXBwb3J0QG9lLjIxdmlhbmV0LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxMjF2cmVxdWVzdC5zdXBwb3J0QG9lLjIxdmlhbmV0LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "contoso.support",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "contoso.support@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxUGVvcGxlOTExMUBzZXJ2aWNlLmV4Y2hhbmdlLm1pY3Jvc29mdC5jb20=')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxUGVvcGxlOTExMUBzZXJ2aWNlLmV4Y2hhbmdlLm1pY3Jvc29mdC5jb20=",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "gethelp@contoso.com",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "gethelp@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxc21hcnRhbGVydHNAbWljcm9zb2Z0LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxc21hcnRhbGVydHNAbWljcm9zb2Z0LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "smartalerts@contoso.com",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "smartalerts@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxam9lQG9saXZlYW5kZ29vc2UuY29t')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxam9lQG9saXZlYW5kZ29vc2UuY29t",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "Emily Burnett",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "emilyb@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxYS1jYW1hbm5AbWljcm9zb2Z0LmNvbQ==')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxYS1jYW1hbm5AbWljcm9zb2Z0LmNvbQ==",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "Bridgett Baxter",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "bridgettb@contoso.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxc3RlZmFuLmJ1cmFrQGluc2lkZXZpZXcuY29t')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxc3RlZmFuLmJ1cmFrQGluc2lkZXZpZXcuY29t",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "Charlotte Stark",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "charlottes@insideview.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxbWFyaWFuYXN0ZXBwQG91dGxvb2suY29t')",
          "Id": "MkU4MDBGNDUtMEY3OS00MzM4LTg3RUUtNENFOTFBRURCODcxbWFyaWFuYXN0ZXBwQG91dGxvb2suY29t",
          "Sources": [
            {
              "Type": "Communication History"
            }
          ],
          "DisplayName": "herminiah@outlook.office.com",
          "GivenName": null,
          "Surname": null,
          "Title": null,
          "EmailAddresses": [
            {
              "Address": "herminiah@outlook.office.com"
            }
          ],
          "CompanyName": null,
          "OfficeLocation": null
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24Filter=Sources%2fAny+(source%3a+source%2fType++eq+%27Communication+History%27)&%24top=10&%24skip=10"
    }

Выбор полей, которые возвращаются в отфильтрованном отклике

Сочетая параметры $select и $filter, вы можете создать настраиваемый список людей, релевантных для пользователя, и получать только те поля, которые необходимы вашему приложению.

В следующем примере DisplayName, а также EmailAddress людей, чье отображаемое имя равно указанному имени. В этом примере возвращаются только люди, чье отображаемое имя равно «Нестор Келлум».

https://outlook.office.com/api/beta/me/people/?$select=DisplayName,EmailAddresses&$Filter=DisplayName eq 'Nestor Kellum' 

Ниже приведен ответ от сервера.

    {
      "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People(DisplayName,EmailAddresses)",
      "value": [
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACfUjORcHM1Juw-lAPzHFIk=')",
          "Id": "AAUQACfUjORcHM1Juw-lAPzHFIk=",
          "DisplayName": "Nestor Kellum",
          "EmailAddresses": [
            {
              "Address": "nestork@contoso.com"
            },
             {
              "Address": "nestork@outlook.office.com"
            }
          ]
        }
      ]
    }

Поиск людей

Поиск темы |

Выполнение нечеткого поиска

Требуемая область: https://outlook.office.com/people.read

Использование поиска для выбора людей

Используйте параметр $search для выбора людей, удовлетворяющих определенному набору критериев.

Следующий поисковый запрос возвращает соответствующих людей, чьи Собственное имя или Фамилия начинается с буквы «j».

https://outlook.office.com/api/beta/me/people/?$search=j

Ниже приведен ответ от сервера.

        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAC4PuXFfR6pAin18WlyOqxI=')",
          "Id": "AAUQAC4PuXFfR6pAin18WlyOqxI=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Jacquelyn Cox",
          "GivenName": "Jacquelyn",
          "Surname": "Cox",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "jacquelync@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building S"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAFE5-QvXOi1KhbNrQQaV-dk=')",
          "Id": "AAUQAFE5-QvXOi1KhbNrQQaV-dk=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Julie Yates",
          "GivenName": "Julie",
          "Surname": "Yates",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "juliey@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 2"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAChuH75CMB5NsGP0QBDcX2g=')",
          "Id": "AAUQAChuH75CMB5NsGP0QBDcX2g=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Juliette Mitchell",
          "GivenName": "Juliette",
          "Surname": "Mitchell",
          "Title": "MANAGER",
          "EmailAddresses": [
            {
              "Address": "juliettem@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building 4"
        },
        {
          "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAMsDacKpHNpFj7ViBXFiRZI=')",
          "Id": "AAUQAMsDacKpHNpFj7ViBXFiRZI=",
          "Sources": [
            {
              "Type": "Directory"
            }
          ],
          "DisplayName": "Katheryn Johns",
          "GivenName": "Katheryn",
          "Surname": "Johns",
          "Title": "ENGINEER",
          "EmailAddresses": [
            {
              "Address": "katherynj@contoso.com"
            }
          ],
          "CompanyName": "CONTOSO",
          "OfficeLocation": "Building T"
        }
      ],
      "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24search=d&%24top=10&%24skip=10"
    }

Использование поиска для указания соответствующей темы

Следующий запрос возвращает соответствующих людей, чье имя содержит «ma» и которые проявили интерес к комику "Aziz Ansari."

 https://outlook.office.com/api/beta/me/people/?$search="ma topic: Aziz Ansari" 

Ниже приведен ответ от сервера.

   {
     "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
     "value": [
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQACgDLi02r8RDmtK-40rUPXE=')",
         "Id": "AAUQACgDLi02r8RDmtK-40rUPXE=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Margret Nash",
         "GivenName": "Margret",
         "Surname": "Nash",
         "Title": "ENGINEER",
         "EmailAddresses": [
           {
             "Address": "margretn@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 4"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAHiSySeJLAtAo6t0FuPmns0=')",
         "Id": "AAUQAHiSySeJLAtAo6t0FuPmns0=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Madelyn Cooley",
         "GivenName": "Madelyn",
         "Surname": "Cooley",
         "Title": "MANAGER",
         "EmailAddresses": [
           {
             "Address": "madelync@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 11"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAAebvnx4LnNKsFWppdcopJw=')",
         "Id": "AAUQAAebvnx4LnNKsFWppdcopJw=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Albert Raley",
         "GivenName": "Albert",
         "Surname": "Raley",
         "Title": "MANAGER",
         "EmailAddresses": [
           {
             "Address": "albertr@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Bulding T"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAPqWcitEhEFNuvaSLteeN9M=')",
         "Id": "AAUQAPqWcitEhEFNuvaSLteeN9M=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Emanuel Grider",
         "GivenName": "Emanuel",
         "Surname": "Grider",
         "Title": "MANAGER",
         "EmailAddresses": [
           {
             "Address": "edh@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 4"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAIqrTSzA3N1BglLTWFzgql4=')",
         "Id": "AAUQAIqrTSzA3N1BglLTWFzgql4=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Frederick Magnuson",
         "GivenName": "Frederick",
         "Surname": "Magnuson",
         "Title": "LEAD",
         "EmailAddresses": [
           {
             "Address": "fredrickm@service.exchange.contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 3"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAId9cw-r_cZDtd5mU6QVvR4=')",
         "Id": "AAUQAId9cw-r_cZDtd5mU6QVvR4=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Beryl Maddox",
         "GivenName": "Beryl",
         "Surname": "Maddox",
         "Title": "MANAGER",
         "EmailAddresses": [
           {
             "Address": "berylm@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 3"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAPbEMn4Y_EhPoPJIAfe9-v4=')",
         "Id": "AAUQAPbEMn4Y_EhPoPJIAfe9-v4=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Vilma Young",
         "GivenName": "Vilma",
         "Surname": "Young",
         "Title": "LEAD",
         "EmailAddresses": [
           {
             "Address": "vilmay@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building T"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQANxLXO4NLchEiyteaLb_HNM=')",
         "Id": "AAUQANxLXO4NLchEiyteaLb_HNM=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Edna Foreman",
         "GivenName": "Edna",
         "Surname": "Foreman",
         "Title": null,
         "EmailAddresses": [
           {
             "Address": "ednaf@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building L"
       },
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAQkADA5OWM3MmE5LTNmYmItNDk1NS1hZDY0LTAwYjBhZjc4MTg3YwAQABMxxzYk20pLinJq19EtuKc=')",
         "Id": "AAQkADA5OWM3MmE5LTNmYmItNDk1NS1hZDY0LTAwYjBhZjc4MTg3YwAQABMxxzYk20pLinJq19EtuKc=",
         "Sources": [
           {
             "Type": "Outlook Contacts"
           }
         ],
         "DisplayName": "Tammi Pickett",
         "GivenName": "Tammi",
         "Surname": "Pickett",
         "Title": "Engineer",
         "EmailAddresses": [
           {
             "Address": "tammip@contoso.com"
           }
         ],
         "CompanyName": "Contoso",
         "OfficeLocation": null
       },
     "@odata.nextLink": "https://outlook.office.com/api/beta/me/people/?%24search=%22ed+topic%3a+Aziz+ansari%22&
%24top=10&%24skip=10"
   }

Выполнение нечеткого поиска

Следующий запрос выполняет поиск человека под именем «Хермаини Холл». Потому что есть соответствующий человек по имени «Хермаини Холл», возвращается информация для «Хермаини Холл».

https://outlook.office.com/api/beta/me/people/?$search="hermaini hall"

Ниже приведен ответ от сервера.

   {
     "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/People",
     "value": [
       {
         "@odata.id": "https://outlook.office.com/api/beta/users/4579DA25-3624-44CD-AE44-9777EEB9D292@F56380F1-06A5-4239-B31E-C8B44DF1F05A/People('AAUQAL5wQK1L1MNNsL4qzoFWZiQ=')",
         "Id": "AAUQAL5wQK1L1MNNsL4qzoFWZiQ=",
         "Sources": [
           {
             "Type": "Directory"
           }
         ],
         "DisplayName": "Herminia Hull",
         "GivenName": "Herminia",
         "Surname": "Hull",
         "Title": "MANAGER",
         "EmailAddresses": [
           {
             "Address": "herminiah@contoso.com"
           }
         ],
         "CompanyName": "CONTOSO",
         "OfficeLocation": "Building 4"
       }
     ]
   }

© 2018 Microsoft