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}
などのlist からの相対指定です。
共通タスク | HTTP メソッド |
---|---|
取得 | GET /items/{item-id} |
列の値を取得する | GET /items/{item-id}?expand=fields |
分析を取得する | GET /items/{item-id}/analytics |
間隔によりアクティビティを取得する | GET /items/{item-id}/getActivitiesByInterval |
作成 | POST /items |
削除 | DELETE /items/{item-id} |
更新 | PATCH /items/{item-id} |
列の値を更新する | PATCH /items/{item-id}/fields |
createLink | POST /items/{itemId}/createLink |
documentSetVersions の一覧表示 | GET /items/{item-id}/documentSetVersions |
documentSetVersion を作成する | POST /items/{item-id}/documentSetVersions |
documentSetVersion の復元 | POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore |
Get delta | GET /items/{item-id}/delta |
プロパティ
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 | このリスト アイテムの列セットの値です。 |
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"
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示