createDerivedAsset

既存のプライマリソース画像アセットから派生する新しいアセットを作成します。

構文

派生アセットは、所有者画像の表現を変更する Image Server プロトコルコマンドを指定します。 この AdjustedView 派生タイプは、単一の画像(切り抜きの長方形など)に簡単な変更を適用するのに役立ちますが、 LayerView は、テキストや追加の画像を含む多層ビューを作成するのに役立ちます。

画像コピーとは異なります ( copyImage) の場合、派生画像はその所有者画像にリンクされます。 所有者の画像を変更すると、関連する派生アセットが変更されます。 所有者画像を削除すると、関連する派生画像がすべて削除されます。

認証済みユーザータイプ

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

パラメータ

入力 (createDerivedAssetParam)

名前 種類 必須 説明
companyHandle xsd:string はい 新しいアセットの派生元となるアセットを含む会社へのハンドル。
ownerHandle xsd:string はい 新しい画像の派生元となるプライマリ画像アセットへのハンドル。
folderHandle xsd:string はい 新しい派生アセットが作成されるフォルダーのハンドル。
name xsd:string はい 派生アセットの名前。
タイプ xsd:string はい 新しい派生アセットのアセットタイプ: AdjustedView または LayerView.
urlModifier xsd:string いいえ 適用される画像サービングまたは画像レンダリングプロトコルコマンド 要求または urlPostApplyModifier コマンド
urlPostApplyModifier xsd:string いいえ 適用される画像サービングまたは画像レンダリングプロトコルコマンド 要求に対して、または urlPostApplyModifier コマンド

出力 (createDerivedAssetParam)

名前 種類 必須 説明
assetHandle xsd:string はい 派生アセットのハンドル。

サンプルコードは、ビューを調整した派生アセットを作成し、 urlModifier および urlPostApplyModifier 任意の値を持つ。 応答は、新しく派生したアセットにハンドルを返します。

リクエスト

<createDerivedAssetParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <ownerHandle>a|943|1|580</ownerHandle>
   <folderHandle>ApiTestCo/</folderHandle>
   <name>ApiDerivedAsset</name>
   <type>AdjustedView</type>
   <urlModifier>modify=this</urlModifier>
   <urlPostApplyModifier>action=awesome</urlPostApplyModifier>
</createDerivedAssetParam>

応答

<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>

このページ