Folders リソース

Folder Information

指定されたフォルダに関する情報を取得します。フォルダの移動、名前の変更、および削除もできます。フォルダを削除すると、そのフォルダ内のフォルダはすべて削除され、削除されたフォルダからすべてのファイルが削除されるため、同期されなくなります。

リソース

1/chatter/folders/folderId

適用開始バージョン

30.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、HEAD、PATCH、DELETE

PATCH のリクエストボディ

Folder Input

PATCH の要求パラメータ

フォルダの移動

パラメータ	型	説明	必須項目/省略可能	使用可能なバージョン
parentFolderId	String	新しい親フォルダの ID。null の場合、フォルダは現在のフォルダから削除されます。指定された ID が root の場合、フォルダはユーザのフォルダ階層のルートに移動します。	必須項目	30.0

フォルダ名の変更

パラメータ	型	説明	必須項目/省略可能	使用可能なバージョン
name	String	フォルダの新しい名前	必須項目	30.0

GET および PATCH のレスポンスボディ

Folder

Folder Contents

フォルダの内容に関する情報を取得します。フォルダへのファイルの追加や、フォルダの作成もできます。

���ォルダを作成するには、POST 要求でリクエストボディまたは要求パラメータを使用できます。

ファイルを作成するには、マルチパート/フォームデータの POST 要求のボディパートとして送信する必要があります。説明とタイトル情報を送信するには、マルチパート/フォームデータ要求の一部として JSON または XML リッチ入力ボディに含めます。または、説明、タイトル、および種別を要求パラメータで送信できます。バイナリファイルのアップロードを参照してください。ファイルを [ファイル] タブに追加するには、/chatter/users/me/filesを使用します。

リソース

1/chatter/folders/folderId/items

適用開始バージョン

30.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、HEAD、POST

GET の要求パラメータ

パラメータ	型	説明	必須項目/省略可能	使用可能なバージョン
page	Integer	項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。	省略可能	30.0
pageSize	Integer	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。	省略可能	30.0

GET のレスポンスボディ

Folder Item Page

POST のリクエストボディ

Folder Item Input

POST の要求パラメータ

フォルダへのファイルの追加

パラメータ	型	説明	必須項目/省略可能	使用可能なバージョン
desc	String	ファイルの説明	省略可能	30.0
title	String	ファイルのタイトル	省略可能	30.0
type	String	項目の種別。ファイルをフォルダに追加するには、値を File にする必要があります。	必須項目	30.0

フォルダの作成

パラメータ	型	説明	必須項目/省略可能	使用可能なバージョン
folderPath	String	フォルダへのパス	必須項目	30.0
type	String	項目の種別。フォルダを作成するには、値を Folder にする必要があります。	必須項目	30.0

POST のレスポンスボディ

Folder Item

ファイルをフォルダに追加する例

1{
2   "file" :
3      {
4         "description" : "Yearly Report for Universal Containers Box Division",
5         "title" : "Yearly.txt"
6      },
7   "type" : "File"
8}

フォルダを作成する例

1{
2   "folder" :
3      {
4         "path" : "my_documents/my_folder"
5      },
6   "type" : "Folder"
7}