ラスター画像アセットのアップロード

画像アセットをアップロードするには、その前に共有秘密キーを要求する必要があります。この共有秘密キーを、アップロードトークンの取得に使用します。次に、アップロードトークンを使用して、ラスター画像アセットをアップロードします。

重要

AdobeDynamic Media Classic での新規または既存の UGC ベクトルアセットのサポートは、2021 年 9 月 30 日に終了しました。

共有秘密鍵のリクエスト

Admin Consoleを使用して 共有秘密鍵 をリクエストし、サポートケースを作成します。 サポートケースで、共有秘密鍵をリクエストします。

電子メールの本文には、画像アセットのアップロードに使用する会社名を記載してください。Dynamic Media Classic からキーを受け取ったら、後で使用するためにローカルに保存します。

アップロードトークンの取得

アップロードトークン​は、ほかのユーザが同じ共有秘密キーを使用してアセットをアップロードすることができないようにします。つまり、アップロードの合法性とソースの信頼性を確保します。

アップロードトークンは英数字で構成された文字列で、一定の期間しか利用できません。アップロードトークンを取得できるよう、共有秘密鍵を代わりに次の URL を使用してください。

  • ラスターイメージ
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602この例では、共有秘密鍵は fece4b21-87ee-47fc-9b99-2e29b78b602

初期設定で、アップロードトークンは取得後 5 分(300 秒)で有効期限切れになります。期限を延長するには、URL に expires パラメータを追加し、必要とする時間を秒単位で入力します。例えば、次のサンプル画像の URL では、1800 秒間有効なアップロードトークンを取得します。

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

画像に対する成功応答は、次のようになります。

<?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>get_uploadtoken</operationName>
        <serviceStatus>SUCCESS</serviceStatus>
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
        <message>
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
            <expiration_in_seconds>1800</expiration_in_seconds>
        </message>
        </response>
    </user_generated_content>
</scene7>

今後の要求で使用できるように、アップロードトークンをローカルに保存します。

クエリ URL 文字列で以下のフィールドを使用して、アップロードトークンを取得できます。

URL パラメータ 必須またはオプション
op 必須 get_uploadtoken
shared_secret 必須 アップロードを行う会社の共有秘密キー。
expires オプション アップロードトークンの有効秒数。指定しない場合は、初期設定の 300 秒になります。

ラスターイメージ URL の例:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

許可されている HTTP メソッド:
GET および POST

これで、画像アセットをアップロードできるようになりました。

画像アセットのアップロード を参照してください。

ラスター画像アセットのアップロード

一定時間有効なアップロードトークンを取得したら、画像アセットをアップロードできます。この例では、マルチパート/フォームとしてアセットをアップロードし、残りの値を 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, TIFF

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

  • 会社名.
  • アップロードトークン.
  • ファイルサイズ制限.
  • ファイル名拡張子のリスト.
  • アセットに関連付けられたカラープロファイルとファイル名を保持するかどうか。
  • ノックアウトの背景を使用するかどうか。 [ ノックアウトの背景 ] を有効にした場合は、[ コーナー ]、[ 公差 ]、および [ 塗りつぶし方法 ] を設定します。
    アップロード時の画像の微調整オプション の「ノックアウトの背景」を参照してください。
  • アップロードするファイルの名前.

上記のフォームに関連付けられている HTML ソースコードを表示するには、「https://s7ugc1.scene7.com/ugc/upload.html」を選択します

Firefox で、ブラウザーウィンドウを右クリックし、「ページソースを表示」を選択します。 コードには、該当する URL クエリ文字列と、ユーザが​「送信」​をクリックしたときに実行される POST メソッドが表示されます。

Internet Explorer で XML 応答を表示するには、View > Source に移動します。 Firefox で XML 応答を表示するには、ツール / ブラウザーツール / Web 開発者ツール に移動します。 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>https://s7w2p1.scene7.com/is/image/ </url>
            <path>000Company/ugc/1442564.tif</path>
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
            </message>
        </response>
    </user_generated_content>
</scene7>
メモ

アップロードされたアセット(JPG、GIF など)は PTIFF 形式に変換され、応答ではその PTIFF アセットへの直接リンクが送信されます。

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

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

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

URL パラメータ 必須またはオプション
op 必須 アップロード
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

画像のアセットメタデータの取得

image_info を使用して、アップロードしたアセットのメタデータを取得できます。次に例を示します。

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

成功した応答の例は次のようになります。

<?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>image_info</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>More information on 1442564.tif</title>
            <message>
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
            <imageFormat>Tiff</imageFormat>
            <colorSpace>Rgb</colorSpace>
            <width>686</width>
            <height>457</height>
            </message>
        </response>
    </user_generated_content>
</scene7>

URL クエリ文字列で以下のフィールドを使用して、アセットの情報を要求できます。

URL パラメータ 必須またはオプション
op 必須 image_info
shared_secret 必須 会社の共有秘密キー.
image_name 必須 画像の名前。

サンプル URL:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

使用可能な HTTP メソッド:

GET と POST

このページ