Skip to main content
ファイルマネージャーは api.apps.files にあります。すべてのメソッドは第 1 引数にアプリ ID、続いてアプリ内のパスを取ります。パスは最大 256 文字です。 サンプルでは、クライアントの作成で作成した api クライアントを使います。appId はあなたのアプリの ID で、api.account.me() で一覧できます。

ディレクトリの一覧

files.list(appId, path?) はディレクトリを一覧します (path を省略した場合はアプリのルート)。
存在しないディレクトリは 404 FILE_NOT_FOUND になります。ファイルマネージャーが公開していないパスは 403 BLOCKED_PATH になります。

ファイルの読み取り

files.read(appId, path) は、ファイルのバイト列を Uint8Array として返します。ファイルは 10 MB までに制限されており、それより大きいファイルは 413 FILE_TOO_LARGE になります。

ファイルの書き込み

files.write(appId, path, content, { signal }) はファイルを作成または上書きします。
  • string はプレーンテキストとして送信されます。
  • Uint8Array は base64 で送信されるため、どんなバイナリ内容もそのまま往復します。
  • 空の内容 ("" または空のバイト列) は空のファイルを作成します。
10 MB を超える内容は、何も送信する前にローカルで FILE_TOO_LARGE (ステータス 0) として失敗します。1 MiB を超える内容はアップロードと同様にタイムアウトなしで送信されるため、キャンセルするには { signal } を渡してください。より大きなファイルには apps.commit() を使います。
書き込んでもアプリは再起動されません。変更を反映するには apps.restart() を呼び出してください。

ファイルの移動または名前変更

ファイルの削除

エラー

すべての呼び出しが返しうるコードについてはエラーを参照してください。

次のステップ

環境変数

アプリの環境変数を読み取り、変更します。

ファイルマネージャー API リファレンス

これらのメソッドが呼び出す REST endpoint。

CLI でファイルを管理

同じ操作をターミナルから行います。