listItem リソースの種類

[アーティクル]
06/18/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}です。

メソッド	戻り値の型	説明
Create	listItem	リストに新しい listItem を作成します。
Get	listItem	リスト内のアイテムを取得する。
更新	fieldValueSet	リストアイテムのプロパティを更新します。
削除	コンテンツはありません	リストからアイテムを削除します。
分析を取得する	itemAnalytics	このリソースの分析を取得します。
列の値を取得する	listItem	リストアイテムから列の値を取得します。
列の値を更新する	fieldValueSet	リストアイテムの列の値を更新します。
ドキュメントセットのバージョンを一覧表示する	documentSetVersion コレクション	リスト内のドキュメントセット項目のバージョンの一覧を取得します。
ドキュメントセットのバージョンを作成する	documentSetVersion	リストにドキュメントセット項目の新しいバージョンを作成します。
ドキュメントセットのバージョンを復元する	コンテンツはありません	ドキュメントセット項目を特定のバージョンに復元します。
Get delta	listItem コレクション	アイテムコレクション全体の完全な読み取りを実行することなく、新しく作成、更新、または削除されたリストアイテムを取得します。
アクセス許可を一覧表示する	permission	listItem に関連付けられているアクセス許可オブジェクトの一覧を取得します。
作成アクセス許可	permission	listItem に関連付けられているアクセス許可オブジェクトの一覧を取得します。
アクセス許可を取得する	permission	listItem に新しいアクセス許可オブジェクトを作成します。
アクセス許可を更新する	permission	listItem のアクセス許可オブジェクトを更新します。
アクセス許可を削除する	なし	listItem のアクセス許可オブジェクトを削除します。

プロパティ

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	このリストアイテムの列セットの値です。
アクセス許可	permission コレクション	アイテムのアクセス許可のセット。読み取り専用です。 Null 許容型です。
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"
}

次の方法で共有