ListItem リソース

名前空間: microsoft.graph

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

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

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

メソッド

listItem リソースで使用可能なメソッドを次に示します。 すべての例は、https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id} の [リスト][] からの相対指定です。

メソッド	戻り値の型	説明
[Get][]	listItem	リスト内のアイテムを取得する。
[列の値 ][Get] を取得	listItem	リスト アイテムから列の値を取得します。
分析を取得する	itemAnalytics	このリソースの分析を取得します。
間隔によりアクティビティを取得する	itemActivityStat	指定した時間間隔内に itemActivityStats のコレクションを取得します。
[作成する][]	listItem	リストに新しい listItem を作成します。
削除	コンテンツはありません	リストからアイテムを削除します。
[更新][]	fieldValueSet	リストアイテム のプロパティを更新します。
[列の値 ][更新]を更新する	fieldValueSet	リスト アイテムの列の値を更新します。

プロパティ

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

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

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

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

リレーションシップ

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

リレーションシップ名	種類	説明
アクティビティ	itemActivity コレクション	このアイテムに対して行われた最近のアクティビティのリストです。
分析	itemAnalytics リソース	このアイテムについて行われたビュー アクティビティに関する分析。
driveItem	driveItem	ドキュメント ライブラリの場合、driveItem リレーションシップは listItem を driveItem として公開します。
フィールド	fieldValueSet	このリスト アイテムの列セットの値です。
versions	listItemVersion コレクション	リスト アイテムの以前のバージョンのリスト。

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"}],
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "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"
}