ListItem リソースListItem resource

このリソースは、SharePoint の list 内のアイテムを表します。This resource represents an item in a SharePoint list. リスト内の列の値は、fieldValueSet ディクショナリから利用できます。Column values in the list are available through the fieldValueSet dictionary.

メソッドMethods

listItem リソースで使用可能なメソッドを次に示します。The following tasks are available for listItem resources. すべての例は、https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id} の**[リスト][]** からの相対指定です。All examples below are relative to a list, eg: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

メソッドMethod 戻り値の型Return Type 説明Description
GetGet lisItemlisItem リスト内のアイテムを取得する。Get an item in a list
列の値 を取得Get column values listItemlistItem リスト アイテムから列の値を取得します。Get column values from listItem.
分析を取得するGet analytics itemAnalyticsitemAnalytics このリソースの分析を取得します。Get analytics for this resource.
[間隔ごとにアクティビティを取得する][]Get activities by interval itemActivityStatitemActivityStat 指定した時間間隔内に itemActivityStats のコレクションを取得します。Get a collection of itemActivityStats within the specified time interval.
[作成する][]Create listItemlistItem リストに新しい listItem を作成します。Create a new listItem in a list.
削除Delete コンテンツはありませんNo Content リストからアイテムを削除します。Removes an item from a list.
[更新][]Update fieldValueSetfieldValueSet リストアイテム のプロパティを更新します。Update the properties on a listItem.
[列の値 ][更新]を更新するUpdate column values fieldValueSetfieldValueSet リスト アイテムの列の値を更新します。Update column values on a listItem.

プロパティProperties

listItem リソースには以下のプロパティがあります。The listItem resource has the following properties.

プロパティ名Property name 種類Type 説明Description
contentTypecontentType contentTypeInfocontentTypeInfo このリスト アイテムのコンテンツ タイプThe content type of this list item

次のプロパティは、baseItem から継承しています。The following properties are inherited from baseItem.

プロパティ名Property name 種類Type 説明Description
idid stringstring アイテムの一意識別子。読み取り専用です。The unique identifier of the item. Read-only.
namename stringstring アイテムの名前/タイトル。The name / title of the item.
createdBycreatedBy identitySetidentitySet このアイテムの作成者の ID です。Identity of the creator of this item. 読み取り専用です。Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset アイテムが作成された日時。読み取り専用です。The date and time the item was created. Read-only.
descriptiondescription stringstring アイテムの説明テキストです。The descriptive text for the item.
eTageTag stringstring アイテムの ETag。読み取り専用です。ETag for the item. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet このアイテムの最終変更者の ID です。Identity of the last modifier of this item. 読み取り専用です。Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset アイテムが最後に変更された日時。読み取り専用です。The date and time the item was last modified. Read-only.
parentReferenceparentReference itemReferenceitemReference 親の情報 (アイテムに親がある場合)。読み取り/書き込み。Parent information, if the item has a parent. Read-write.
sharepointIdssharepointIds sharepointIdssharepointIds SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。Returns identifiers useful for SharePoint REST compatibility. Read-only.
webUrlwebUrl string (URL)string (url) ブラウザーでアイテムを表示する URL。読み取り専用です。URL that displays the item in the browser. Read-only.

リレーションシップRelationships

listItem リソースには、他のリソースと次のような関係があります。The listItem resource has the following relationships to other resources.

リレーションシップ名Relationship name 種類Type 説明Description
アクティビティactivities itemActivity コレクションitemActivity collection このアイテムに対して行われた最近のアクティビティのリストです。The list of recent activities that took place on this item.
分析analytics itemAnalytics リソースitemAnalytics resource このアイテムについて行われたビュー アクティビティに関する分析。Analytics about the view activities that took place in this site.
driveItemdriveItem driveItemdriveItem ドキュメント ライブラリの場合、driveItem リレーションシップは listItem を driveItem として公開します。For document libraries, the driveItem relationship exposes the listItem as a driveItem
フィールドfields fieldValueSetfieldValueSet このリスト アイテムの列セットの値です。The values of the columns set on this list item.
versionsversions listItemVersion コレクションlistItemVersion collection リスト アイテムの以前のバージョンのリスト。The list of previous versions of the list item.

JSON 表記JSON representation

以下は、listItem リソースの JSON 表記です。Here is a JSON representation of a listItem resource.

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