「東雲忠太郎」の平凡な日常のできごと

2023.12.31

REST:フォルダー内にリストアイテムを作成

カテゴリ： REST API

SharePointのREST APIを使用して、特定のフォルダー内にリストアイテムを作成するには、次の手順に従います。以下の例では、リストの特定のフォルダーパス内に新しいアイテムを作成します。

POSTリクエストの構築:

POST /_api/web/lists/getbytitle('YourList')/items

Content-Type: application/json;odata=verbose

Accept: application/json;odata=verbose

リクエストヘッダーに Content-Type と Accept を指定し、リクエストボディに作成するアイテムのプロパティを含んだJSONデータを渡します。

リクエストボディの作成:

作成するアイテムのプロパティをJSON形式で指定します。また、FileDirRef プロパティにフォルダーのパスを指定します。

{

"__metadata": { "type": "SP.Data.YourListListItem" },

"Title": "New Item",

"ColumnName": "Value",

"FileDirRef": "/sites/YourSite/Lists/YourList/YourFolder"

}

__metadata プロパティにはアイテムのメタデータが含まれ、type にはリストのエンティティの型が指定されます。他のプロパティはリストのフィールドに対応しています。

リクエストを送信:

上記で構築したREST APIリクエストを使用して、フォルダー内のリストアイテムを作成します。

例えば、curlを使用する場合：

# SharePoint サイト URL

siteUrl="https://your-sharepoint-site-url"

# リストのタイトル

listTitle="YourList"

# REST API リクエストを送信

curl -X POST "$siteUrl/_api/web/lists/getbytitle('$listTitle')/items" -H "Content-Type: application/json;odata=verbose" -H "Accept: application/json;odata=verbose" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -d '{

"__metadata": { "type": "SP.Data.YourListListItem" },

"Title": "New Item",

"ColumnName": "Value",

"FileDirRef": "/sites/YourSite/Lists/YourList/YourFolder"

この例では、YourList というタイトルのリストの YourFolder フォルダー内に新しいアイテムを作成しています。YOUR_ACCESS_TOKEN は適切な認証トークンに置き換える必要があります。なお、実際の環境に合わせてURLやリストのタイトル、フォルダーパス、アイテムのプロパティを変更してください。

お気に入りの記事を「いいね！」で応援しよう