Тип ресурса SharingLink
Ресурс SharingLink группирует связанные со ссылками элементы данных в единую структуру.
Если у ресурса Permission имеется аспект sharingLink, значение которого отлично от NULL, разрешение представляет ссылку для совместного доступа (а не разрешение, предоставляемое пользователю или группе).
Представление JSON
Ниже представлено описание ресурса в формате JSON.
{
"application": { "@odata.type": "microsoft.graph.identity" },
"type": "view | edit | embed",
"scope": "anonymous | organization",
"webHtml": "string",
"webUrl": "url"
}
Свойства
Свойство | Тип | Описание |
---|---|---|
application | identity | Приложение, с которым сопоставлена ссылка. |
type | Строка | Тип созданной ссылки. |
scope | String | Область ссылки, представленная этим разрешением. Значение anonymous указывает, что ссылку может использовать любой пользователь, значение organization указывает, что ссылку могут использовать только пользователи, выполнившие вход в один и тот же клиент. |
webHtml | String | Для ссылок embed это свойство содержит HTML-код элемента <iframe> , который внедряет элемент на веб-страницу. |
webUrl | Строка | URL-адрес, который открывает элемент в браузере на веб-сайте OneDrive. |
Параметры типа
В таблице ниже определены возможные значения свойства type.
Значение | Роль | Описание |
---|---|---|
view |
read |
Ссылка для совместного доступа на просмотр, разрешающая доступ только для чтения. |
edit |
write |
Ссылка для редактирования, разрешающая доступ для чтения и записи. |
embed |
read |
Ссылка только для просмотра, с помощью которой можно внедрять содержимое в ведущую веб-страницу. Внедряемые ссылки недоступны в OneDrive для бизнеса и SharePoint. |
Параметры области
Значение | Описание |
---|---|
anonymous |
Любой пользователь со ссылкой обладает правом доступа без необходимости входа в систему. Это также относится к людям вне вашей организации. |
organization |
Любой пользователь, вошедший в вашу организацию (клиент), может использовать ссылку для получения доступа. Доступно только в OneDrive для бизнеса и SharePoint. |