itemReference 资源类型
命名空间:microsoft.graph
提供通过 API 对 driveItem 或 listItem 进行寻址所需的信息。
属性
属性 | 类型 | 说明 |
---|---|---|
driveId | String | 包含 driveItem 的驱动器实例的唯一标识符。 仅当项位于 驱动器中时才返回。 此为只读属性。 |
driveType | String | 标识驱动器的类型。 仅当项位于 驱动器中时才返回。 请参阅 drive 资源查看其值。 |
id | String | 驱动器中 driveItem 或列表中的 listItem 的唯一标识符。 只读。 |
name | 字符串 | 所引用的项的名称。 只读。 |
路径 | String | 可用于导航到项的百分比编码路径。 只读。 |
shareId | String | 可通过 Shares API 访问的共享资源的唯一标识符。 |
sharepointIds | sharepointIds | 返回对 SharePoint REST 兼容性有用的标识符。 只读。 |
siteId | String | 对于 OneDrive for Business 和 SharePoint,此属性表示包含 driveItem 资源的父文档库或 listItem 资源的父列表的网站 ID。 该值与该站点资源的 id 属性相同。 它是一个 不透明的字符串,由网站的三个标识符组成 。 对于 OneDrive,不会填充此属性。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"driveId": "string",
"driveType": "personal | business | documentLibrary",
"id": "string",
"name": "string",
"path": "string",
"shareId": "string",
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"siteId": "string"
}
备注
为了从 itemReference 资源中找到 driveItem,请构建以下格式的 URL:
GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{id}
路径值是相对于目标驱动器的百分比编码 API 路径,例如:/drive/root:/Documents/my%20file.docx
。
要检索人工可读路径中的痕迹,可以放心地忽略路径字符串中的第一个 :
之前的所有内容。