sharePointBrowseSession: обзор

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

Важно!

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

Просмотрите файлы и папки в sharePointBrowseSession.

Разрешения

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

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

Примечание.

В делегированном потоке доступ к этому API могут получить только пользователи с ролью администратора резервного копирования SharePoint .

HTTP-запрос

POST /solutions/backupRestore/sharePointBrowseSessions/{sharePointBrowseSessionId}/browse

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

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

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

В тексте запроса укажите представление следующих параметров в формате JSON.

Параметр Тип Описание
browseLocationItemKey String Ключ элемента расположения, которое требуется просмотреть. Необязательный параметр.
browseResourceType browsableResourceType Тип расположения для просмотра. Необязательный параметр. Возможные значения: none, site, documentLibrary, folderи unknownFutureValue. Необязательный параметр.
filter String Содержит выражение поиска. Необязательный параметр.
Orderby browseQueryOrder Указывает порядок, по которому должен быть упорядочен ответ. Необязательный параметр.

В следующей таблице приведены примеры возможных форматов для выражения фильтра. Фильтр поддерживается только для name свойства .

Property Оператор Пример
name -contains (name -contains 'contoso')

Отклик

В случае успешного 200 OK выполнения эта функция возвращает код отклика и коллекцию browseQueryResponseItem в тексте отклика.

Примеры

Пример 1. Получение наиболее доступных для просмотра расположений

Запрос

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

POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointBrowseSessions/m_RtZ8BiiUXOK69cuN6gwubfm9_yeVlDg8s6hci01_cVOAE/browse

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.browseQueryResponseItem)",
    "@odata.count": 1,
    "value": [
        {
            "itemKey": "f3846f8d-80a6-4480-ae20-5966ebdf2009,26380145-c085-4772-b5ef-94de6bc9447e",
            "name": "Communication site",
            "webUrl": "https://contoso.sharepoint.com",
            "type": "site"
        }
    ]
}

Пример 2. Обзор указанного ресурса

Запрос

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

POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointBrowseSessions/m_RtZ8BiiUXOK69cuN6gwubfm9_yeVlDg8s6hci01_cVOAE/browse
Content-Type: application/json

{
    "browseLocationItemKey": "f3846f8d-80a6-4480-ae20-5966ebdf2009,26380145-c085-4772-b5ef-94de6bc9447e",
    "browseResourceType": "site"
}

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.browseQueryResponseItem)",
    "@odata.count": 10,
    "@odata.nextLink": "https://graph.microsoft.com/beta/solutions/backupRestore/sharePointBrowseSessions/m_RtZ8BiiUXOK69cuN6gwubfm9_yeVlDg8s6hci01_cVOAE/browse?$skiptoken=eyJ0eXBlIjoiRm9sZGVyIiwiZmlsdGVyIjoiIiwiaXRlbWtleSI6ImJiMjgxZjcyLWY3Y2MtNDM3OS1iMjk1LTBjNjEyNTMxMjdhZiw3NzA0MmZjYi03NGUzLTQ2YWEtOGE1My0wNWY5NzM5ZWJkZjQsMDdhNzEyNWEtMTVlMy00MDJkLWJlYjktZWU2NTQwZjdmNWJjLGE3MWUyZWZjLThmNTctNGIzOS1hNGE5LTNhNGU2MmZkMDM3YiIsInNraXB0b2tlbiI6IlVHRm5aV1E5VkZKVlJTWndYMU52Y25SQ1pXaGhkbWx2Y2owd0puQmZTVVE5TVRZNUpsSnZiM1JHYjJ4a1pYSTlKVEptY0dWeWMyOXVZV3dsTW1aMWMyVnlNQ1UxWm1FNE16QmxaR0ZrT1RBMU1EZzBPVzFoYm1selpIWXdOeVUxWm05dWJXbGpjbTl6YjJaMEpUVm1ZMjl0SlRKbVJHOWpkVzFsYm5SekpUSm1ZWEJwIn0",
    "value": [
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,2db4d4a9-7a10-409d-acfb-136101b43ba8",
            "name": "objectdelete-sharepointbrowsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointbrowsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2594"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,e3cca06d-b45d-4e98-bd16-c57a4563776f",
            "name": "objectdelete-browsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-browsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2411"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,cd692efa-0297-4a98-a39b-ec568a118f35",
            "name": "objectdelete-sharepointrestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointrestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2605"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,24c84b57-692b-40b3-b0b0-9cb8613b4398",
            "name": "objectdelete-restoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-restoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2422"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,b74f9233-27a7-4d49-a723-c9a4ab717d2d",
            "name": "objectdelete-exchangerestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-exchangerestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2484"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,4f20a6c4-c999-4ee8-9552-ca6a7fc46edf",
            "name": "objectdelete-sharepointbrowsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointbrowsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2493"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,92d28cdf-82b4-4964-b6fa-fd61240acf6c",
            "name": "objectdelete-sharepointrestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointrestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2504"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,cbd8e3c8-d0da-40a8-8eb8-51699268d6cf",
            "name": "objectenable.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectenable.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2853"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,45cccd01-511c-4705-97b6-8884d2397e3c",
            "name": "objectget.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectget.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2966"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,ef0ebe75-df09-43d0-91b6-705f03e0b006",
            "name": "objectlist-browsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectlist-browsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "3254"
        }
    ]
}

Мы получаем nextLink в ответ на первый вызов API POST, как показано выше, и последующие страницы извлекаются с помощью следующей ссылки.

Запрос

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

GET https://graph.microsoft.com/beta/solutions/backupRestore/sharePointBrowseSessions/m_RtZ8BiiUXOK69cuN6gwubfm9_yeVlDg8s6hci01_cVOAE/browse?$skiptoken=nextFetchToken

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.browseQueryResponseItem)",
    "@odata.count": 10,
    "value": [
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,b74f9233-27a7-4d49-a723-c9a4ab717d2d",
            "name": "objectdelete-exchangerestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-exchangerestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2484"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,4f20a6c4-c999-4ee8-9552-ca6a7fc46edf",
            "name": "objectdelete-sharepointbrowsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointbrowsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2493"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,92d28cdf-82b4-4964-b6fa-fd61240acf6c",
            "name": "objectdelete-sharepointrestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointrestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2504"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,cbd8e3c8-d0da-40a8-8eb8-51699268d6cf",
            "name": "objectenable.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectenable.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2853"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,e3cca06d-b45d-4e98-bd16-c57a4563776f",
            "name": "objectdelete-browsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-browsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2411"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,cd692efa-0297-4a98-a39b-ec568a118f35",
            "name": "objectdelete-sharepointrestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointrestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2605"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,24c84b57-692b-40b3-b0b0-9cb8613b4398",
            "name": "objectdelete-restoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-restoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2422"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,b74f9233-27a7-4d49-a723-c9a4ab717d2d",
            "name": "objectdelete-exchangerestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-exchangerestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2484"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,4f20a6c4-c999-4ee8-9552-ca6a7fc46edf",
            "name": "objectdelete-sharepointbrowsesessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointbrowsesessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2493"
        },
        {
            "itemKey": "bb281f72-f7cc-4379-b295-0c61253127af,77042fcb-74e3-46aa-8a53-05f9739ebdf4,07a7125a-15e3-402d-beb9-ee6540f7f5bc,92d28cdf-82b4-4964-b6fa-fd61240acf6c",
            "name": "objectdelete-sharepointrestoresessions.md",
            "webUrl": "https://contoso.sharepoint.com/Shared Documents/api/objectdelete-sharepointrestoresessions.md",
            "type": "file",
            "itemsCount": 0,
            "sizeInBytes": "2504"
        }
    ]
}
  • Last updated on