画像アセットをアップロードするには、その前に共有秘密キーを要求する必要があります。この共有秘密キーを、アップロードトークンの取得に使用します。次に、アップロードトークンを使用して、ラスター画像アセットをアップロードします。
2023 年 5 月 1 日以降、Dynamic Mediaの UGC アセットは、アップロード日から最大 60 日間使用できます。 60 日後にアセットが削除されます。
Adobe Dynamic Media Classicでの新規または既存の UGC ベクトルアセットのサポートは、2021 年 9 月 30 日に終了しました。
リクエスト a 共有秘密鍵 作成者 Admin Consoleを使用してサポートケースを作成します。 サポートケースで、共有秘密鍵をリクエストします。
電子メールの本文には、画像アセットのアップロードに使用する会社名を記載してください。Adobe 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 応答を表示するには、に移動します。 表示 > ソース. 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