sharingLink 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

sharingLink 资源将链接相关的数据项分组到单个结构中。

如果 权限 资源具有非 null sharingLink 方面，则权限表示共享链接 (而不是授予) 人员或组的权限。

JSON 表示形式

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

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

属性

属性	类型	说明
application	Identity	链接所关联的应用。
type	String	创建的链接类型。
scope	String	由该权限表示的链接范围。值 anonymous 表示该链接对任何人均可用，organization 表示该链接仅可由登录到同一个租户的用户使用。
preventsDownload	Boolean	如果为 true，则用户只能使用此链接来查看 Web 上的项，并且无法使用它来下载项目的内容。 仅适用于OneDrive Entreprise和 SharePoint。
webHtml	String	对于 embed 链接，此属性包含在网页上嵌入项的 <iframe> 元素的 HTML 代码。
webUrl	String	在 OneDrive 网站上的浏览器中打开项的 URL。

类型选项

下表定义了 type 属性的可能值。

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

范围选项

下表定义了 scope 属性的可能值。

值	说明
anonymous	拥有该链接的任何人都可以访问，无需登录。 这可能包括组织外部的人员。
organization	登录到组织（租户）的任何人都可以使用该链接获取访问权限。 仅适用于 OneDrive for Business 和 SharePoint。
existingAccess	只有已通过其他方式获得该项目访问权限的人员才能使用此链接访问该项目。 仅适用于 OneDrive for Business 和 SharePoint。
users	该链接仅授予对特定人员列表的访问权限。 仅适用于 OneDrive for Business 和 SharePoint。