itemReference 资源类型

命名空间:microsoft.graph

itemReference 资源提供了通过 API 对 driveItemlistItem 进行寻址所需的信息。

属性

属性 类型 说明
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

要检索人工可读路径中的痕迹,可以放心地忽略路径字符串中的第一个 : 之前的所有内容。