разрешение: предоставление
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предоставьте пользователям доступ к ссылке, представленной разрешением.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Files.ReadWrite | Files.ReadWrite.All, Sites.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | Files.ReadWrite.All | Sites.ReadWrite.All |
HTTP-запрос
POST /shares/{encoded-sharing-url}/permission/grant
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.
{
"recipients": [
{ "@odata.type": "microsoft.graph.driveRecipient" }
],
"roles": [ "read | write"]
}
Параметр | Тип | Описание |
---|---|---|
recipients | Collection(driveRecipient) | Коллекция получателей, которые получат доступ. |
roles | Collection(String) | Если ссылка является ссылкой "существующий доступ", указывает роли, которые будут предоставлены пользователям. В противном случае должен соответствовать роли ссылки. |
Список доступных ролей см. в разделе Значения свойств ролей.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и коллекцию разрешений в тексте ответа.
Разрешение, представляющее обновленную ссылку, всегда будет возвращаться в результирующем наборе при успешном выполнении. Обновленную ссылку можно определить по наличию аспекта link, содержащего свойство "область". В некоторых случаях возможно, что обновленная ссылка имеет URL-адрес, отличный от исходной ссылки, и в этом случае следует использовать новый URL-адрес.
Дополнительные сведения о возвращении ошибок см. в статье Отклики с ошибками.
Пример
В этом примере пользователи john@contoso.com и ryan@external.com доступ к ссылке общего доступа предоставляются без изменения других существующих разрешений на ссылку.
Запрос
POST https://graph.microsoft.com/beta/shares/{encoded-sharing-url}/permission/grant
Content-type: application/json
{
"recipients": [
{
"email": "john@contoso.com"
},
{
"email": "ryan@external.com"
}
],
"roles": ["read"]
}
Отклик
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"hasPassword": false,
"id": "5fab944a-47ec-48d0-a9b5-5178a926d00f",
"link": {
"preventsDownload": false,
"scope": "users",
"type": "view",
"webUrl": "https://contoso.sharepoint.com/:t:/g/design/EZexPoDjW4dMtKFUfAl6BK4BvIUuss52hLYzihBfx-PD6Q"
},
"roles": [
"read"
]
}
]
}
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
Если ссылка является существующей ссылкой для доступа , будут возвращены дополнительные разрешения, представляющие следующее:
- Разрешения типа пользователя, представляющие получателей, которым был успешно предоставлен доступ. Их можно определить по наличию свойства grantedTo .
- Разрешения типа ссылки, представляющие приглашения, которые необходимо отправить нераспознанным внешним пользователям, чтобы они получили доступ. Их можно определить по наличию аспекта приглашения . Эти записи будут содержать ссылку с URL-адресом приглашения, а коллекция grantedToIdentities будет указывать пользователей, которым должна быть отправлена ссылка.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"hasPassword": false,
"id": "00000000-0000-0000-0000-000000000000",
"link": {
"preventsDownload": false,
"scope": "existingAccess",
"type": "view",
"webUrl": "https://contoso.sharepoint.com/teams/design/shareddocs/Document.docx"
},
"roles": [
"read"
]
},
{
"grantedTo": {
"user": {
"displayName": "John Smith",
"email": "john@contoso.com",
"id": "47aecee2-d061-4730-8ecb-4c61360441ae"
}
},
"id": "aTowIy5mfG1lbWJlcnNoaXB8bGltaXRlZDJAa2xhbW9kYi5vbm1pY3Jvc29mdC5jb20",
"roles": [
"read"
]
},
{
"grantedToIdentities": [
{
"user": {
"email": "ryan@external.com"
}
}
],
"invitation": {
"signInRequired": true
},
"roles": [
"read"
],
"link": {
"type": "view",
"webUrl": "https://contoso.sharepoint.com/:t:/g/teams/design/EZexPoDjW4dMtKFUfAl6BK4Bw_F7gFH63O310A7lDtK0mQ"
}
}
]
}
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.