тип ресурса sharingLink

Статья
03/26/2023

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

Важно!

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

Ресурс sharingLink объединяет связанные с связью элементы данных в одну структуру.

Если ресурс разрешений имеет аспект sharingLink , отличный от NULL, разрешение представляет ссылку для общего доступа (в отличие от разрешений, предоставленных пользователю или группе).

Представление JSON

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

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "preventsDownload": false,
  "type": "view | edit | embed",
  "scope": "anonymous | organization",
  "webHtml": "string",
  "webUrl": "url"
}

Свойства

Свойство	Тип	Описание
application	identity	Приложение, с которым сопоставлена ссылка.
type	Строка	Тип созданной ссылки.
scope	String	Область ссылки, представленная этим разрешением. Значение `anonymous` указывает, что ссылку может использовать любой пользователь, значение `organization` указывает, что ссылку могут использовать только пользователи, выполнившие вход в один и тот же клиент.
preventsСкачать	Логический	Если значение равно true, пользователь может использовать эту ссылку только для просмотра элемента в Интернете и не может использовать его для скачивания содержимого элемента. Только для OneDrive для бизнеса и SharePoint.
webHtml	String	Для ссылок `embed` это свойство содержит HTML-код элемента `<iframe>`, который внедряет элемент на веб-страницу.
webUrl	Строка	URL-адрес, который открывает элемент в браузере на веб-сайте OneDrive.

Параметры типа

В следующей таблице определены возможные значения для свойства type .

Значение	Роль	Описание
`view`	`read`	Ссылка для совместного доступа на просмотр, разрешающая доступ только для чтения.
`edit`	`write`	Ссылка для редактирования, разрешающая доступ для чтения и записи.
`embed`	`read`	Ссылка только для просмотра, с помощью которой можно внедрять содержимое в ведущую веб-страницу. Внедряемые ссылки недоступны в OneDrive для бизнеса и SharePoint.

Параметры области

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

Значение	Описание
`anonymous`	Любой пользователь со ссылкой обладает правом доступа без необходимости входа в систему. Это также относится к людям вне вашей организации.
`organization`	Любой пользователь, вошедший в вашу организацию (клиент), может использовать ссылку для получения доступа. Доступно только в OneDrive для бизнеса и SharePoint.
`existingAccess`	Только пользователи, которым уже предоставлен доступ к элементу с помощью других средств, могут получить доступ к элементу по этой ссылке. Доступно только в OneDrive для бизнеса и SharePoint.
`users`	Ссылка предоставляет доступ только к определенному списку людей. Доступно только в OneDrive для бизнеса и SharePoint.