SharingLink 资源类型

SharingLink 资源将与链接相关的数据项分组到一个单一结构。

如果 权限 资源有一个非 NULL sharingLink facet,则该权限表示共享链接(而不是授予给用户或组的权限)。

JSON 表示形式

下面是资源的 JSON 表示形式。

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

属性

属性 类型 说明
application Identity 链接所关联的应用。
type String 创建的链接类型。
scope String 由该权限表示的链接范围。 值 anonymous 表示该链接对任何人均可用,organization 表示该链接仅可由登录到同一个租户的用户使用。
webHtml String 对于 embed 链接,此属性包含在网页上嵌入项的 <iframe> 元素的 HTML 代码。
webUrl String 在 OneDrive 网站上的浏览器中打开项的 URL。

类型选项

此表定义了 type 属性的可能值:

角色 说明
view read 可查看共享链接,允许只读访问。
edit write 授予读写权限的编辑共享链接。
embed read 可用于将内容嵌入托管网页的仅供查看共享链接。 OneDrive for Business 或 SharePoint 不支持嵌入链接。

范围选项

说明
anonymous 拥有该链接的任何人都可以访问,无需登录。 这可能包括组织外部的人员。
organization 登录到组织(租户)的任何人都可以使用该链接获取访问权限。 仅适用于 OneDrive for Business 和 SharePoint。