ListItem リソース

名前空間: microsoft.graph

重要

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

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

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

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

listItem に関するタスク

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 /items/{item-id}/delta

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" },
  "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"
}

プロパティ

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