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