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 | 布尔值 | 如果为 true，则用户只能使用此链接在 Web 上查看项目，而不能使用它来下载项目的内容。 仅适用于 OneDrive for Business 和 SharePoint。 |
| webHtml | String | 对于 embed 链接，此属性包含在网页上嵌入项的 <iframe> 元素的 HTML 代码。 |
| webUrl | String | 在 OneDrive 网站上的浏览器中打开项的 URL。 |
类型选项
下表定义了 类型 属性的可能值。
| 值 | 角色 | 说明 |
|---|---|---|
view |
read |
可查看共享链接，允许只读访问。 |
edit |
write |
授予读写权限的编辑共享链接。 |
embed |
read |
可用于将内容嵌入托管网页的仅供查看共享链接。 OneDrive for Business 或 SharePoint 不支持嵌入链接。 |
范围选项
下表定义了 范围 属性的可能值。
| 值 | 说明 |
|---|---|
anonymous |
拥有该链接的任何人都可以访问，无需登录。 这可能包括组织外部的人员。 |
organization |
登录到组织（租户）的任何人都可以使用该链接获取访问权限。 仅适用于 OneDrive for Business 和 SharePoint。 |
existingAccess |
只有已通过其他方式获得项目访问权限的人员才能使用此链接访问该项目。 仅适用于 OneDrive for Business 和 SharePoint。 |
users |
该链接仅向特定的人员列表授予访问权限。 仅适用于 OneDrive for Business 和 SharePoint。 |