List リソース

[アーティクル]
04/08/2023

list リソースは site 内のリストを表します。このリソースには、テンプレートとフィールドの定義を含め、リストの最上位レベルのプロパティが含まれています。

リスト上のタスク

list リソースで使用可能なタスクを次に示します。注: このベータ版では、リスト上の移動だけが可能であり、リストの作成や更新はできません。ただし、リストアイテムを作成または更新することはできます。

以下のすべての例は、https://graph.microsoft.com/v1.0/sites/{site-id} などのサイトからの相対指定です。

共通タスク	HTTP メソッド
リストを取得する	GET /lists/{list-id}
リストアイテムを列挙する	GET /lists/{list-id}/items
リストアイテムを更新する	PATCH /lists/{list-id}/items/{item-id}
リストアイテムを削除する	DELETE /lists/{list-id}/items/{item-id}
リストアイテムを作成する	POST /lists/{list-id}
最近のアクティビティを取得する	GET /lists/{list-id}/activities

JSON 表記

以下は、list リソースの JSON 表記です。

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "displayName": "title of list",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "items": [ { "@odata.type": "microsoft.graph.listItem" } ],
  "list": {
    "@odata.type": "microsoft.graph.listInfo",
    "hidden": false,
    "template": "documentLibrary | genericList | survey | links | announcements | contacts | accessRequest ..."
  },
  "system": false,

  /* inherited from baseItem */
  "id": "string",
  "name": "name of list",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of list",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "webUrl": "url to visit the list in a browser"
}

プロパティ

list リソースには以下のプロパティがあります。

プロパティ名	種類	説明
displayName	string	リストの表示可能なタイトルです。
list	listInfo	リストに関する追加の詳細を示します。
system	systemFacet	存在する場合は、これがシステム管理のリストであることを示しています。読み取り専用です。

次のプロパティは、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。読み取り専用です。

リレーションシップ

list リソースには、他のリソースと次のような関係があります。

リレーションシップ名	種類	説明
activities	itemActivity コレクション	このリスト内で行われた最近のアクティビティです。
drive	drive	ドキュメントライブラリにのみ存在します。 driveItems で drive リソースとしてリストへのアクセスを許可します。
items	Collection(listItem)	リストに含まれているすべてのアイテム。
列	Collection(columnDefinition)	このリストのフィールド定義のコレクションです。
contentTypes	Collection(contentType)	このリスト内に存在するコンテンツタイプのコレクションです。

次の方法で共有

List リソース

リスト上のタスク

JSON 表記

プロパティ

リレーションシップ

その他のリソース