ファイルを追加、更新、または削除する

固定リンクがコピーされました

ファイルを追加する

固定リンクがコピーされました

追加するファイルの情報をリクエストのパラメーターとして受け取り、追加処理を実行後、追加したファイルの情報をレスポンスとして返すAPIです。

API名

固定リンクがコピーされました

CabinetAddFile

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
@hid	base:IDType	1	フォルダーID
@name	xsd:string	1	ファイル名
@title	xsd:string	0～1	タイトル
@version	base:IDType	0～1	管理する世代数
@description	xsd:string	0～1	説明
content/text()	xsd:Base64Binary	1	Base64でエンコードされたファイルデータ

例

1
2
3
4
5


<parameters hid="4" name="file.txt" title="file" description="description"> 
  <content xmlns=""> 
    FFQVBJgsyQ3Yx2gsyRUIK1iKuCtYKqi2OYX4KzguqCxIKigsiFC 
  </content> 
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
file	cabinet:SimpleFileType	1	ファイルの情報

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


<returns xmlns=""> 
  <file id="3" folder_id="4"> 
    <title>file</title> 
    <max_version>0</max_version> 
    <name>file.txt</name> 
    <size>2205</size> 
    <mime_type>text/plain</mime_type> 
    <creator_id>1</creator_id> 
    <creator_login_name>Administrator</creator_login_name> 
    <creator_display_name>Administrator</creator_display_name> 
    <create_time>1283220783</create_time> 
    <description>description</description> 
  </file> 
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_UTIL_API_65009	アップロードするファイルのサイズが、Base64エンコード後で300MBより大きい場合

ファイルを更新する

固定リンクがコピーされました

ファイルを更新するAPIです。

API名

固定リンクがコピーされました

CabinetUpdateFile

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.1以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
@file_id	base:IDType	1	ファイルID
@name	xsd:string	1	ファイル名
@comment	xsd:string	0～1	コメント
content	xsd:Base64Binary	1	Base64でエンコードされたファイルデータ

例

1
2
3


<parameters file_id="2" name="test.txt" comment="comment"> 
  <content xmlns="">12345</content> 
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
file	cabinet:SimpleFileInformationType	1	更新したファイル情報

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


<returns> 
  <file id="2" folder_id="2" xmlns:cab="http://schemas.cybozu.co.jp/cabinet/2008"> 
    <cab:title>2</cab:title> 
    <cab:max_version>0</cab:max_version> 
    <cab:name>test.txt</cab:name> 
    <cab:size>3</cab:size> 
    <cab:mime_type>text/plain</cab:mime_type> 
    <cab:creator_id>1</cab:creator_id> 
    <cab:creator_login_name>Administrator</cab:creator_login_name> 
    <cab:creator_display_name>Administrator</cab:creator_display_name> 
    <cab:create_time>2011-05-23T07:58:09Z</cab:create_time> 
    <cab:modifier_id>1</cab:modifier_id> 
    <cab:modifier_login_name>Administrator</cab:modifier_login_name> 
    <cab:modifier_display_name>Administrator</cab:modifier_display_name> 
    <cab:modify_time>2011-05-23T08:14:51Z</cab:modify_time> 
    <cab:description></cab:description> 
  </file> 
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_CBNT_17004	指定したファイルが存在しない場合
GRN_CBNT_17009	フォルダーにファイルを追加する権限が存在しない場合
GRN_CMMN_00202	指定したファイルを他の他のユーザーが操作中の場合
GRN_UTIL_API_65009	アップロードするファイルのサイズが、Base64エンコード後で300MBより大きい場合

ファイル情報を更新する

固定リンクがコピーされました

ファイルの管理情報を更新するAPIです。

API名

固定リンクがコピーされました

CabinetUpdateFileInformation

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.1以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
@file_id	base:IDType	1	ファイルID
@title	xsd:string	0～1	タイトル
@version	base:IDType	0～1	バージョン管理の世代数
@description	xsd:string	0～1	ファイルの説明

例

1
2
3


<parameters file_id="2" title="updated title" version="10"
 description="updated desc"> 
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
file	cabinet:SimpleFileInformationType	1	更新したファイル情報

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


<returns> 
  <file id="2" folder_id="2" xmlns:cab="http://schemas.cybozu.co.jp/cabinet/2008"> 
    <cab:title>updated title</cab:title> 
    <cab:max_version>10</cab:max_version> 
    <cab:name>test.txt</cab:name> 
    <cab:size>3</cab:size> 
    <cab:mime_type>text/plain</cab:mime_type> 
    <cab:creator_id>1</cab:creator_id> 
    <cab:creator_login_name>Administrator</cab:creator_login_name> 
    <cab:creator_display_name>Administrator</cab:creator_display_name> 
    <cab:create_time>2011-05-23T07:58:09Z</cab:create_time> 
    <cab:modifier_id>1</cab:modifier_id> 
    <cab:modifier_login_name>Administrator</cab:modifier_login_name> 
    <cab:modifier_display_name>Administrator</cab:modifier_display_name> 
    <cab:modify_time>2011-05-23T08:16:36Z</cab:modify_time> 
    <cab:description>updated desc</cab:description> 
  </file> 
</return>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_CBNT_17004	指定したファイルが存在しない場合
GRN_CBNT_17009	ファイルを更新する権限が存在しない場合

ファイルを削除する

固定リンクがコピーされました

ファイルを削除するAPIです。

API名

固定リンクがコピーされました

CabinetDeleteFiles

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.1以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
file_id/text()	base:IDType	1	削除するファイルのID

例

1
2
3


<parameters> 
  <file_id xmlns="">2</file_id> 
</parameters>

レスポンス

固定リンクがコピーされました

なし

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_CBNT_17004	指定したファイルが存在しない場合
GRN_CBNT_17008	指定したファイルが存在するフォルダーに閲覧権限がない場合
GRN_CBNT_17024	指定したファイルに対する削除権限がない場合

Garoon API

Garoon APIドキュメント