ListItem リソース

[アーティクル]
04/05/2024

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

SharePoint のリスト内のアイテムを表します。

SharePoint のドキュメントライブラリにあるすべてのアイテムは、llistItem または driveItem リソースとして表すことができます。

リスト内の列の値は、fieldValueSet ディクショナリから利用できます。

メソッド

listItem リソースで使用可能なタスクを次に示します。以下のすべての例は、https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id} などのlist からの相対指定です。

共通タスク	HTTP メソッド
取得	GET /items/{item-id}
列の値を取得する	GET /items/{item-id}?expand=fields
分析を取得する	GET /items/{item-id}/analytics
間隔によりアクティビティを取得する	GET /items/{item-id}/getActivitiesByInterval
作成	POST /items
削除	DELETE /items/{item-id}
更新	PATCH /items/{item-id}
列の値を更新する	PATCH /items/{item-id}/fields
createLink	POST /items/{itemId}/createLink
documentSetVersions の一覧表示	GET /items/{item-id}/documentSetVersions
documentSetVersion を作成する	POST /items/{item-id}/documentSetVersions
documentSetVersion の復元	POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore
Get delta	GET /items/{item-id}/delta

プロパティ

listItem リソースには以下のプロパティがあります。

プロパティ	型	説明
contentType	contentTypeInfo	このリストアイテムのコンテンツタイプ

次のプロパティは、baseItem から継承しています。

プロパティ名	種類	説明
id	string	アイテムの一意識別子。読み取り専用です。
name	string	アイテムの名前/タイトル。
createdBy	identitySet	このアイテムの作成者の ID です。読み取り専用です。
createdDateTime	DateTimeOffset	アイテムが作成された日時。読み取り専用です。
説明	string	アイテムの説明テキストです。
eTag	string	アイテムの ETag。読み取り専用です。
lastModifiedBy	identitySet	このアイテムの最終変更者の ID です。読み取り専用です。
lastModifiedDateTime	DateTimeOffset	アイテムが最後に変更された日時。読み取り専用です。
parentReference	itemReference	親の情報 (アイテムに親がある場合)。読み取り/書き込み。
sharepointIds	sharepointIds	SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。
webUrl	string (URL)	ブラウザーでアイテムを表示する URL。読み取り専用です。

リレーションシップ

listItem リソースには、他のリソースと次のような関係があります。

リレーションシップ	型	説明
アクティビティ	itemActivity コレクション	このアイテムに対して行われた最近のアクティビティのリストです。
分析	itemAnalytics リソース	このアイテムについて行われたビューアクティビティに関する分析。
documentSetVersions	documentSetVersion コレクション	ユーザーによって作成されたドキュメントセットバージョンのバージョン情報。
driveItem	driveItem	ドキュメントライブラリの場合、driveItem リレーションシップは listItem を driveItem として公開します。
フィールド	fieldValueSet	このリストアイテムの列セットの値です。
versions	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"
}