Список "Общие"
Пространство имен: microsoft.graph
Вычисляемая аналитика, включающая список документов, которыми предоставлен общий доступ пользователю.
Эта аналитика включает документы, размещенные в OneDrive или SharePoint в клиенте Microsoft 365 пользователя, которые предоставляются пользователю, а также документы, вложенные в виде файлов и отправляемые пользователю.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Sites.Read.All | Sites.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
Получение списка документов, к которым предоставлен доступ пользователю, выполнившего вход.
Примечание. Только пользователь может выполнять запросы, используя идентификатор пользователя или имя участника.
GET /me/insights/shared
GET /users/{id | userPrincipalName}/insights/shared
Разверните ресурс, на который ссылается общая аналитика:
GET https://graph.microsoft.com/v1.0/me/insights/shared/{id}/resource
Необязательные параметры запросов
Этот метод поддерживает параметры запросов OData для настройки ответа.
Параметр запроса можно использовать для $filter
фильтрации общих элементов. Например, на основе типа:
https://graph.microsoft.com/v1.0/me/insights/shared?$filter=ResourceVisualization/Type eq 'PowerPoint'
См. доступные типы контейнеров и типы, по которым можно фильтровать в resourceVisualization.
Вы также можете получить файлы, к которым предоставлен общий доступ определенному пользователю. Например, указав lastshared/sharedby/address
свойство :
https://graph.microsoft.com/v1.0/me/insights/shared?$filter=lastshared/sharedby/address eq '[email protected]'
См. сложный тип sharingDetail .
Заголовки запросов
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и список общих элементов в тексте ответа.
Пример
Примеры
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/me/insights/shared
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "AWb0Qy4TEA1KhLW-k1L5mSjtxZAcxDFkTKiTNA-2kZDTXzrMX_4FhECOU0bKZVj1uReivYoYYoJNqTeuC-x1Agtm9EMuExANSoS1vpNS-ZkoBA",
"lastShared": {
"sharedDateTime": "2021-03-23T08:41:05Z",
"sharingType": "Direct",
"sharedBy": {
"displayName": "Megan Bowen",
"address": "[email protected]",
"id": "3e0c9f05-b9b8-4cf5-9b35-a4e11b24b5b7"
},
"sharingReference": {}
},
"resourceVisualization": {
"title": "CE Annual Report",
"type": "Word",
"mediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"previewImageUrl": "https://contoso-my.sharepoint.com/_api/v2.0/drives/b!ZvRDLhMQDUqEtb6TUvmZKO3FkBzEMWRMqJM0D7aRkNNfOsxf_gWEQI5TRsplWPW5/items/01K6ZMU4QXUK6YUGDCQJG2SN5OBPWHKAQL/thumbnails/0/small/thumbnailContent",
"previewText": "Contoso Annual Report Anne Wallace Sales Contoso today announced financial results for its most recent fi",
"containerWebUrl": "https://contoso-my.sharepoint.com/personal/meganb_m365x841051_onmicrosoft_com/Documents/Forms/All.aspx",
"containerDisplayName": "Megan Bowen",
"containerType": "OneDriveBusiness"
},
"resourceReference": {
"webUrl": "https://contoso-my.sharepoint.com/personal/meganb_m365x841051_onmicrosoft_com/_layouts/15/Doc.aspx?sourcedoc=%7B8ABDA217-6218-4D82-A937-AE0BEC75020B%7D&file=CE%20Annual%20Report.docx&action=default&mobileredirect=true&DefaultItemOpen=1",
"id": "drives/b!ZvRDLhMQDUqEtb6TUvmZKO3FkBzEMWRMqJM0D7aRkNNfOsxf_gWEQI5TRsplWPW5/items/01K6ZMU4QXUK6YUGDCQJG2SN5OBPWHKAQL",
"type": "microsoft.graph.driveItem"
}
}
]
}