listItem 资源类型

命名空间：microsoft.graph

重要

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

表示 SharePoint 列表中的项目。

SharePoint 文档库中的所有项目可以表示为 listItem 或 driveItem 资源。

该列表中的列值可通过 fieldValueSet 字典获得。

方法

下列任务可用于 listItem 资源。 所有示例都相对于列表;例如 。 https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}

方法	返回类型	说明
Create	listItem	在列表中创建新的 listItem。
获取	listItem	获取列表中的项。
Update	fieldValueSet	更新 listItem 上的属性。
删除	无内容	从 list 中删除项。
获取分析结果	itemAnalytics	对此资源可获取分析。
获取列值	listItem	从 listItem 获取列的值。
更新列值	fieldValueSet	更新 listItem 上的列值。
列出文档集版本	documentSetVersion 集合	获取列表中文档集项的版本列表。
创建文档集版本	documentSetVersion	在列表中创建文档集项的新版本。
还原文档集版本	无内容	将文档集项还原到特定版本。
获取增量	listItem 集合	获取新创建、更新或删除 的列表项 ，而无需执行整个项目集合的完全读取。
列出权限	权限	获取与 listItem 关联的权限对象列表。
创建权限	权限	获取与 listItem 关联的权限对象列表。
获取权限	权限	在 listItem 上创建新的权限对象。
更新权限	权限	更新 listItem 上的权限对象。
删除权限	无	删除 listItem 上的权限对象。

属性

listItem 资源具有以下属性。

属性	类型	说明
contentType	contentTypeInfo	此列表项的内容类型

以下属性继承自 baseItem。

属性名称	类型	说明
id	string	项的唯一标识符。 只读。
name	string	项目名称/标题。
createdBy	identitySet	此项的创建者的标识。 只读。
createdDateTime	DateTimeOffset	项的创建日期和时间。 只读。
说明	string	项目的描述性文本。
eTag	字符串	该项目的 ETag。 只读。
lastModifiedBy	identitySet	此项的最后一个修饰符的标识。 只读。
lastModifiedDateTime	DateTimeOffset	上次修改项目的日期和时间。 此为只读属性。
parentReference	itemReference	父信息（如果此项具有父级）。 读写。
sharepointIds	sharepointIds	返回对 SharePoint REST 兼容性有用的标识符。 只读。
webUrl	string (url)	在浏览器中显示项的 URL。 只读。

关系

listItem 资源与其他资源具有以下关系。

关系	类型	说明
activities	itemActivity 集合	最近发生在此项上的活动的列表。
分析	itemAnalytics 资源	此项目上发生的查看活动的相关分析。
documentSetVersions	documentSetVersion 集合	用户创建的文档集版本的版本信息。
driveItem	driveItem	对于文档库，driveItem 关系将 listItem 显示为 driveItem。
fields	fieldValueSet	在此列表项上设置的列的值。
permissions	权限 集合	项目的权限集。 只读。 可为 NULL。
版本	listItemVersion 集合	先前版本的列表项的列表。

JSON 表示形式

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

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "documentSetVersions": [{"@odata.type": "microsoft.graph.documentSetVersion"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}