実行可能な処理設定
連携を構築
この Template は Dropbox から画像をひとつインポートしてリサイズし、共有リンクを作成せずに出力を /processed に返します。
- ワークフローに必要なファイルスコープとコンテンツへのアクセス権を持つ Dropbox アプリを作成するか、選択してください。
- Transloadit の Template 認証情報として、my_dropbox_credentials という名前で接続してください。
- 処理設定を Template に貼り付け、その Template から Assembly を開始してください。
Template の処理設定
{
"steps": {
"imported": {
"robot": "/dropbox/import",
"credentials": "my_dropbox_credentials",
"path": "/incoming/photo.jpg"
},
"resized": {
"robot": "/image/resize",
"use": "imported",
"width": 1200,
"height": 1200,
"resize_strategy": "fit"
},
"exported": {
"robot": "/dropbox/store",
"use": "resized",
"credentials": "my_dropbox_credentials",
"path": "/processed/${file.url_name}",
"create_sharing_link": false
}
}
}認証
- Transloadit の Template 認証情報画面で Dropbox アプリを接続し、ワークフローに必要な最小限のコンテンツアクセス権とスコープを選択してください。
- 連携機能が自身のファイルのみを管理する場合は、App Folder アクセスで十分です。アカウント内のほかの場所にある既存のファイルにアクセスするには、Full Dropbox が必要です。
- Dropbox のユーザーは認可を取り消せるため、本番環境のワークフローでは、認証情報のエラーを復旧可能な連携エラーとして扱う必要があります。
制限事項と運用上の注意点
- Dropbox のパスは、アプリで選択したコンテンツルートからの相対パスです。同じ表示パスでも、App Folder アプリと Full Dropbox アプリでは参照先が異なる場合があります。
- 末尾がスラッシュのディレクトリパスを指定すると、配下の項目が再帰的にインポートされ、Assembly が大規模になる場合があります。必要なオブジェクトがひとつだけの場合は、ファイルパスを指定してください。
- create_sharing_link は結果の URL を Dropbox の共有リンクに変更します。共有リンクを作成しないワークフローでは、false のままにしてください。
その他の連携
技術スタックの構築を続ける
Amazon S3
専用の Robot で Amazon S3 からのインポートと Amazon S3 へのエクスポートを行います。
Cloudflare R2
インポートと保存専用の Robot で R2 オブジェクトを処理します。
Supabase
S3 互換エンドポイント経由で Supabase Storage に接続します。
Tigris
専用の Robot で Tigris オブジェクトをインポート、エクスポートできます。