ListItem 资源

此资源表示 SharePoint list 中的项目。 该列表中的列值可通过 fieldValueSet 字典获得。

listItem 上的任务

下列任务可用于 listItem 资源。 下面的所有示例都与list相关，例如：https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}。

常见任务	HTTP 方法
获取	GET /items/{item-id}
获取列值	GET /items/{item-id}?expand=fields
创建	POST /items
删除	DELETE /items/{item-id}
更新	PATCH /items/{item-id}
更新列值	PATCH /items/{item-id}/fields

JSON 表示形式

下面是 listItem 资源的 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"}],
  "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"
}

属性

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 集合	最近发生在此项上的活动的列表。
driveItem	driveItem	对于文档库，driveItem 关系将 listItem 显示为 driveItem。
fields	fieldValueSet	在此列表项上设置的列的值。
版本	listItemVersion 集合	先前版本的列表项的列表。