listItem 资源类型

命名空间:microsoft.graph

表示 SharePoint 列表中的项目。

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

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

方法

下列方法可用于 listItem 资源。 所有示例都与 list 相关:https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}

方法 返回类型 说明
获取 listItem 获取列表中的项。
获取列值 listItem 从 listItem 获取列的值。
获取分析结果 itemAnalytics 对此资源可获取分析。
按间隔获取活动 itemActivityStat 在指定的时间间隔内获取 itemActivityStats 的集合。
Create listItem 在列表中创建新的 listItem。
删除 无内容 从 list 中删除项。
Update fieldValueSet 更新 listItem 上的属性。
更新列值 fieldValueSet 更新 listItem 上的列值。
List documentSetVersion 集合 获取列表中文档集项的版本列表。
创建 documentSetVersion Create列表中文档集项的新版本。
还原 无内容 将文档集项还原到特定版本。
获取增量 listItem 集合 获取新创建、更新或删除 的列表项 ,而无需执行整个项目集合的完全读取。

属性

listItem 资源具有以下属性。

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

以下属性继承自 baseItem

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

关系

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

关系 类型 说明
activities itemActivity 集合 最近发生在此项上的活动的列表。
分析 itemAnalytics 资源 此项目上发生的查看活动的相关分析。
documentSetVersions documentSetVersion 集合 用户创建的文档集版本的版本信息。
driveItem driveItem 对于文档库,driveItem 关系将 listItem 显示为 driveItem
fields fieldValueSet 在此列表项上设置的列的值。
版本 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"
}