ListItem リソース

  • [アーティクル]

このリソースは、SharePoint の list 内のアイテムを表します。 リスト内の列の値は、fieldValueSet ディクショナリから利用できます。

listItem に関するタスク

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

共通タスク HTTP メソッド
取得 GET /items/{item-id}
列の値を取得する GET /items/{item-id}?expand=fields
作成 POST /items
削除 DELETE /items/{item-id}
更新 PATCH /items/{item-id}
列の値を更新する PATCH /items/{item-id}/fields

JSON 表記

以下は、listItem リソースの 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"}],
  "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"
}

プロパティ

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 コレクション このアイテムに対して行われた最近のアクティビティのリストです。
driveItem driveItem ドキュメント ライブラリの場合、driveItem リレーションシップは listItem を driveItem として公開します。
フィールド fieldValueSet このリスト アイテムの列セットの値です。
versions listItemVersion コレクション リスト アイテムの以前のバージョンのリスト。