画像アセットのアップロード

一定時間有効なアップロードトークンを取得したら、画像アセットをアップロードできます。この例では、マルチパート/フォームとしてアセットをアップロードし、残りの値を URL クエリ文字列として送信します。

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

upload_token および company_name フィールドは必須です。

詳しくは、アップロードトークンの取得を参照してください。

詳しくは、共有秘密キーの要求を参照してください。

この例のように、他のオプションの値も URL クエリ文字列として送信できます。

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif

file_limit パラメータでは、ファイルサイズ制限をバイト単位で指定します。file_exts パラメータでは、アップロード可能なファイル名拡張子を指定します。この 2 つのパラメータはオプションです。

ファイルサイズ制限とファイル名拡張子に適用されるグローバル制限は、アプリケーション内で設定されます。要求での送信内容がグローバル制限のサブセットの場合は、この制限が適用されます。グローバル制限は次のとおりです。

グローバル制限

すべてのクライアントのファイルサイズ

20MB

アップロードでサポートされている画像ファイルの形式

BMP、GIF、JPG、PNG、PSD

アセットのアップロードには次の HTML フォームを使用できます。フォームからは次の情報の入力が求められます。

  • 会社名

  • アップロードトークン

  • ファイルサイズ制限

  • ファイル名拡張子のリスト

  • アップロードするファイルの名前

フルサイズのグラフィックを表示
アセットをアップロードするための HTML フォーム。

図に示されたフォームに対して、ブラウザウィンドウを右クリックし、「ソースの表示」をクリックすると、次の HTML コードが表示されます。コードには、該当する URL クエリ文字列と、ユーザが「送信」をクリックしたときに実行される POST メソッドが表示されます。

<html> 
<body> 
    <script language="javascript"> 
        function uploadImage() 
        { 
            var preserve_colorprofile = "false"; 
            if(document.image_upload.preserve_colorprofile[0].checked == true){ 
                preserve_colorprofile = "true"; 
            } 
            var preserve_filename = "false"; 
            if(document.image_upload.preserve_filename[0].checked == true){ 
                preserve_filename = "true"; 
            } 
document.image_upload.action="https://s7ugc1.scene7.com/ugc/image?op=upload&company_name="+document.image_upload.company_name.value+"&upload_token="+document.image_upload.upload_token.value+"&file_limit="+document.image_upload.file_limit.value+"&file_exts="+document.image_upload.file_exts.value+"&preserve_colorprofile="+preserve_colorprofile+"&preserve_filename="+preserve_filename; 
            return true; 
        } 
    </script> 
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload" onSubmit="return uploadImage();"> 
<table> 
<tr><td colspan="2"><strong> UGC Image Upload Test Page: </strong></td></tr> 
<tr><td colspan="2"></td></tr> 
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40" name="company_name"></td></tr> 
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40" name="upload_token"></td></tr> 
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40" name="file_limit">&nbsp;bytes</td></tr> 
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40" name="file_exts"></td></tr> 
<tr><td><strong> Preserve Color Profile</strong></td><td><input type="radio"  name="preserve_colorprofile" value="true">Yes&nbsp;&nbsp;<input type="radio"  name="preserve_colorprofile" value="false" checked>No</td></tr> 
<tr><td><strong> Preserve File Name</strong></td><td><input type="radio"  name="preserve_filename" value="true">Yes&nbsp;&nbsp;<input type="radio"  name="preserve_filename" value="false" checked>No</td></tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
    <td><strong>File to upload: : </strong></td> 
    <td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td> 
</tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
    <td><strong>Click Submit to upload your image: </strong></td> 
    <td><input type="submit" value="Submit"></td> 
</tr> 
</table> 
</form> 
</body> 
</html>

XML 応答を Internet Explorer で表示するには、表示ソースをクリックします。XML 応答を Firefox で表示するには、表示ページのソースをクリックします。XML 応答の表示には、Firefox を使用することをお勧めします。

以下は、アップロードが正常に完了した場合のサンプル応答です。

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<scene7> 
    <user_generated_content> 
        <response> 
            <serviceName>User Generated Content - Images</serviceName> 
            <version>1.0.0</version> 
            <operationName>upload</operationName> 
            <serviceStatus>SUCCESS</serviceStatus> 
            <title>Your file has been uploaded Successfully.</title> 
            <message> 
            <url>http://s7w2p1.scene7.com/is/image/ </url> 
            <path>000Company/ugc/1442564.tif</path> 
            <fullurl>http://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>
注意: アップロードされたアセット(JPG、GIF など)は PTIFF 形式に変換され、応答ではその PTIFF アセットへの直接リンクが送信されます。

ほかの ImageServing リソースの場合と同様に、アセットには処理クエリを適用できます。例えば、以下の URL は、指定された幅と高さにストレッチされたアセットを要求します。

http://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

アップロードするアセットをマルチパート/フォームとしてアップロードし、残りの値を URL クエリ文字列として送信します。URL クエリ文字列で以下のフィールドを使用して、アセットをアップロードできます。

URL パラメータ

必須またはオプション

op

必須

upload

upload_token

必須

会社と関連付けられている共有秘密キーに対応するアップロードトークン。

company_name

必須

アップロードを実行する会社の名前。

file_limit

オプション

アセットのファイルサイズ制限(バイト単位)。

file_exts

オプション

画像アセットファイルで許可される拡張子のリスト。

preserve_colorprofile

オプション

アップロードされたファイルを PTIFF 形式に変換するときに埋め込まれているカラープロファイルを保持します。値は true または false。初期設定は false。

preserve_filename

オプション

アップロードされたアセットのファイル名を保持します。値は true または false。初期設定は false。

注意: アップロードするアセットは、マルチパート POST 要求の唯一のフィールドとして送信する必要があります。

サンプル URL:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

使用可能な HTTP メソッド:

POST