createDerivedAsset createderivedasset

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

構文

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

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

認証済みユーザータイプ authorized-user-types

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

パラメーター section-5a0dde01cff6454da3646ea805c2be1e

入力 (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
はい
派生アセットのハンドル。

section-5d5ea893a1ef4edc8b3a396f1936e8c9

サンプルコードは、ビューを調整した派生アセットを作成し、 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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681