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

ディレクトリの一覧

files.list(app_id, path=None) はディレクトリを一覧します (path を省略した場合はアプリのルート)。他の省略可能な修飾引数と異なり、path は位置引数として渡せます。
存在しないディレクトリは 404 FILE_NOT_FOUND になります。ファイルマネージャーが公開していないパスは 403 BLOCKED_PATH になります。

ファイルの読み取り

files.read(app_id, path) は、ファイルの内容を bytes として返します。ファイルは 10 MB に制限されており、それより大きいものは 413 FILE_TOO_LARGE になります。

ファイルの書き込み

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

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

ファイルの削除

エラー

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

次のステップ

環境変数

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

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

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

CLI でファイルを管理

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