ListItem リソース

名前空間: microsoft.graph

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

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

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

メソッド

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

メソッド 戻り値の型 説明
Get listItem リスト内のアイテムを取得する。
列の値を取得する listItem リスト アイテムから列の値を取得します。
分析を取得する itemAnalytics このリソースの分析を取得します。
間隔ごとにアクティビティを取得する itemActivityStat 指定した時間間隔内に itemActivityStats のコレクションを取得します。
作成する listItem リストに新しい listItem を作成します。
削除 コンテンツはありません リストからアイテムを削除します。
更新 fieldValueSet リストアイテム のプロパティを更新します。
列の値を更新する fieldValueSet リスト アイテムの列の値を更新します。
documentSetVersions の一覧表示 documentSetVersion コレクション リスト内のドキュメント セット項目のバージョンの一覧を取得します。
documentSetVersion を作成する documentSetVersion リストにドキュメント セット項目の新しいバージョンを作成します。
documentSetVersion の復元 コンテンツはありません ドキュメント セット項目を特定のバージョンに復元します。

プロパティ

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

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

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

プロパティ 説明
createdBy identitySet このアイテムの作成者の ID です。 読み取り専用です。
createdDateTime DateTimeOffset アイテムが作成された日時。 読み取り専用です。
説明 string アイテムの説明テキストです。
eTag string アイテムの ETag。 読み取り専用です。
id string アイテムの一意識別子。 読み取り専用です。
lastModifiedBy identitySet このアイテムの最終変更者の ID です。 読み取り専用です。
lastModifiedDateTime DateTimeOffset アイテムが最後に変更された日時。 読み取り専用です。
name string アイテムの名前/タイトル。
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"
}