Поделиться через

тип ресурса sharingLink

  • Статья

Пространство имен: 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.