ローカルおよびリモートアップロードの仕組み
ローカルおよびリモートアップロードの仕組み
このガイドでは、Frame.io V4 API を使用してファイルをアップロードするための完全なフローを詳しく説明します。
前提条件
ファイルのアップロードを開始する前に、次の設定手順が完了していることを確認してください。
Frame.io V4 アカウント
Adobe Admin Console を介して管理されている Frame.io V4 アカウントがあるか、アカウントユーザーの Adobe 認証に切り替え 済みである
アップロードメソッドの選択
Frame.io API を使用してファイルをアップロードするには、次の 2 つの方法、Create File (local upload) および Create File (remote upload) があります。
デスクトップからファイルをドラッグするのと同様に、メディアがアプリケーションにローカルでアクセスできる場合に使用します
別のサービスとの統合など、ネットワーク経由でメディアにアクセスする場合に使用します
このガイドでは、リモートアップロードを完了する簡単なケースから始めます。
リモートアップロード
リモートアップロードを使用してファイルを作成するには、Create File (remote upload) エンドポイントを選択します。リクエスト本文には、ファイル名とそのソース URL が必要です。
要求の例
レスポンスの例
要求が成功すると、次のようなレスポンスが返されます。
ローカルアップロード
ローカルアップロードを使用してファイルを作成するには、Create File (local upload) エンドポイントを選択します。リクエスト本文には、ファイル名とそのファイルサイズをバイト単位で指定する必要があります。
要求の例
レスポンスの例
要求が成功すると、コンテンツが含まれないプレースホルダーのファイルリソースが作成されます。ファイルサイズに応じて、応答本文には 1 つ以上の upload_urls が含まれます。この例では、このアップロードを複数のパートで管理する必要があります。
重要なアップロード要件:
後続のアップロード要求を送信する際には、次の重要な点に注意する必要があります。
- HTTP 要求メソッドは
PUTである必要があります x-amz-aclヘッダーを含め、「private」に設定する必要がありますContent-Typeヘッダーは、元の Create File (local upload) 要求で指定されたmedia_typeと一致する必要があります。これは、ファイルを個別の部分としてアップロードする場合でも該当します。上記の例では、media_typeの値はimage/jpegです。したがって、Content-Typeの値もimage/jpegである必要があります。
マルチパートアップロード
特定のファイルが複数のアップロード URL になる場合、ソースファイルをチャンクに分割し、同じ数の後続する要求を発行するシェルスクリプトを作成すると便利です。
以下の Python スクリプトのサンプルでは、upload_urls パラメーターに複数のアップロード URL を渡しています。
Python の実装例
アップロードフローの要約
次の手順:ファイルのアップロード後、返されたファイル ID を使用して、コメントの追加、共有の作成、または Frame.io V4 API を使用したその他の操作を実行できます。