ラスター画像アセットのアップロード uploading-an-image-asset-or-a-vector-asset
画像アセットをアップロードするには、その前に共有秘密キーを要求する必要があります。この共有秘密キーを、アップロードトークンの取得に使用します。その後、アップロードトークンを使用して、ラスター画像アセットをアップロードします。
共有秘密鍵のリクエスト requesting-a-shared-secret-key
Admin Consoleを使用して shared-secret key をリクエストし、サポートケースを作成します。🔗 テクニカルサポートケースでは、共有秘密鍵をリクエストします。
電子メールの本文には、画像アセットのアップロードに使用する会社名を記載してください。Adobe Dynamic Media Classicからキーを受け取ったら、後で使用するためにローカルに保存します。
アップロードトークンの取得 retrieving-the-upload-token
アップロードトークン は、ほかのユーザが同じ共有秘密キーを使用してアセットをアップロードすることができないようにします。つまり、アップロードの合法性とソースの信頼性を確保します。
アップロードトークンは英数字で構成された文字列で、一定の期間しか利用できません。次の 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:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
許可される HTTP メソッド：GET と POST
これで、画像アセットをアップロードできるようになりました。
画像アセットのアップロードを参照してください。
ラスター画像アセットのアップロード uploading-an-image-asset
一定時間有効なアップロードトークンを取得したら、画像アセットをアップロードできます。この例では、マルチパート／フォームとしてアセットをアップロードし、残りの値を 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 つのパラメータはオプションです。
ファイルサイズ制限とファイル名拡張子に適用されるグローバル制限は、アプリケーション内で設定されます。リクエストで送信したものがグローバル制限のサブセットである場合、そのリクエストは優先されます。 グローバル制限は次のとおりです。
アセットのアップロードには次の HTML フォームを使用できます。フォームからは次の情報の入力が求められます。
- 会社名。
- アップロードトークン。
- ファイルサイズの上限。
- ファイル名拡張子のリスト。
- アセットに関連付けられたカラープロファイルとファイル名を保持するかどうか。
- ノックアウトの背景を使用するかどうか。 [ 背景の抜き ] を有効にした場合は、[ コーナー ]、[ 許容差 ]、[ 塗り潰し方法 ] を設定します。
アップロード時の画像の微調整オプションのノックアウトの背景を参照してください。 - アップロードするファイルの名前。
上記のフォームに関連付けられたHTMLのソース コードを表示するには、https://s7ugc1.scene7.com/ugc/upload.html を選んでください。
Firefox で、ブラウザーウィンドウ内を右クリックし、「ページSourceを表示」を選択します。 このコードは、対応する URL クエリ文字列と、ユーザーが 送信 を選択したときに実行されるPOSTメソッドを示しています。
Internet Explorer で XML 応答を表示するには、表示 > 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>
ほかの ImageServing リソースの場合と同様に、アセットには処理クエリを適用できます。例えば、次の URL は指定された幅と高さに拡大されたアセットをリクエストします。
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
アップロードするアセットをマルチパート／フォームとしてアップロードし、残りの値を URL クエリ文字列として送信します。URL クエリ文字列で以下のフィールドを使用して、アセットをアップロードできます。
opupload_tokencompany_namefile_limitfile_extspreserve_colorprofilepreserve_filenameサンプル URL：
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
使用可能な HTTP メソッド：
POST
画像のアセットメタデータの取得 getting-asset-metadata-for-images
次の例に示すように、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 クエリ文字列で以下のフィールドを使用して、アセットの情報を要求できます。
opshared_secretimage_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