ローカルおよびリモートアップロードの仕組み
ローカルおよびリモートアップロードの仕組み
ローカルおよびリモートアップロードの仕組み
このガイドでは、Frame.io V4 API を使用してファイルをアップロードするための完全なフローを詳しく説明します。
ファイルのアップロードを開始する前に、次の設定手順が完了していることを確認してください。
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 が含まれます。この例では、このアップロードを複数のパートで管理する必要があります。
重要なアップロード要件:
後続のアップロード要求を送信する際には、次の重要な点に注意する必要があります。
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 を渡しています。
次の手順:ファイルのアップロード後、返されたファイル ID を使用して、コメントの追加、共有の作成、または Frame.io V4 API を使用したその他の操作を実行できます。