ドキュメントDynamic Media Image Production System API

batchSetImageFields

最終更新日: 2024年7月22日
  • トピック:

作成対象:

  • 開発者
  • 管理者

1 つ以上の画像アセットに対して画像固有のフィールドを設定します。

構文

許可されているユーザータイプ

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

パラメーター

入力(batchSetImageFields)

名前種類必須説明
companyHandlexsd:stringはい画像アセットを含む会社へのハンドル。
updateArraytypes:ImageFieldUpdateArrayはい画像フィールドの配列が更新されます。

出力(batchSetImageFields)

名前種類必須説明
successCountxsd:intはい正常に設定された画像フィールドの数。
warningCountxsd:intはい操作で画像フィールドを設定しようとしたときに生成された警告の数。
errorCountxsd:intはい操作で画像フィールドを設定しようとしたときに生成されたエラーの数です。
warningDetailArraytypes:AssetOperationFaultArrayいいえ操作が更新を適用しようとした際に警告を生成したアセットに関連付けられた詳細の配列。
errorDetailArraytypes:AssetOperationFaultArrayいいえ操作が更新を適用しようとしたときにエラーが発生したアセットに関連付けられた詳細の配列です。

例

この例では、更新配列の 2 つの画像のフィールドにデータを設定します。 配列では、画像はアセットハンドルで指定され、ピクセル単位の解像度、x 位置と y 位置のアンカー座標、ユーザーデータが含まれます。 応答は、両方の画像のフィールドが正常に設定されたことを示します。

リクエスト

<batchSetImageFieldsParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <updateArray>
      <items>
         <assetHandle>a|140626|1|102524</assetHandle>
         <resolution>72</resolution>
         <anchorX>50</anchorX>
         <anchorY>100</anchorY>
         <userData>nada1</userData>
      </items>
      <items>
         <assetHandle>a|96680|1|64865</assetHandle>
         <resolution>150</resolution>
         <anchorX>100</anchorX>
         <anchorY>50</anchorY>
         <userData>nada2</userData>
      </items>
   </updateArray>
</batchSetImageFieldsParam>

応答

<batchSetImageFieldsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</batchSetImageFieldsReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681