名前空間: microsoft.graph
SharePoint のリスト内のアイテムを表します。
SharePoint のドキュメント ライブラリにあるすべてのアイテムは、llistItem または driveItem リソースとして表すことができます。
リスト内の列の値は、fieldValueSet ディクショナリから利用できます。
メソッド
listItem リソースで使用可能なメソッドを次に示します。
すべての例は、https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id} のリスト からの相対指定です。
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | listItem コレクション | リスト内のアイテムのコレクションを取得します。 |
| Get | listItem | リスト内のアイテムを取得する。 |
| 列の値を取得する | listItem | リスト アイテムから列の値を取得します。 |
| 分析を取得する | itemAnalytics | このリソースの分析を取得します。 |
| 間隔によりアクティビティを取得する | itemActivityStat | 指定した時間間隔内に itemActivityStats のコレクションを取得します。 |
| 作成する | listItem | リストに新しい listItem を作成します。 |
| 削除 | コンテンツはありません | リストからアイテムを削除します。 |
| 更新 | fieldValueSet | リストアイテム のプロパティを更新します。 |
| 列の値を更新する | fieldValueSet | リスト アイテムの列の値を更新します。 |
| ドキュメント セットのバージョンを一覧表示する | documentSetVersion コレクション | リスト内のドキュメント セット項目のバージョンの一覧を取得します。 |
| Create | documentSetVersion | リストにドキュメント セット項目の新しいバージョンを作成します。 |
| 復元 | コンテンツはありません | ドキュメント セット項目を特定のバージョンに復元します。 |
| Get delta | listItem コレクション | アイテム コレクション全体の完全な読み取りを実行することなく、新しく作成、更新、または削除された リスト アイテムを取得します。 |
プロパティ
listItem リソースには以下のプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| contentType | contentTypeInfo | このリスト アイテムのコンテンツ タイプ |
次のプロパティは、baseItem から継承しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| createdBy | identitySet | このアイテムの作成者の ID です。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | アイテムが作成された日時。 読み取り専用です。 |
| deleted | deleted | デルタ列挙の結果に存在する場合は、項目が削除されたことを示します。 読み取り専用です。 |
| 説明 | 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" },
"deleted": { "@odata.type": "microsoft.graph.deleted" },
"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"
}