次の方法で共有


listItem リソースの種類

名前空間: 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"
}