文件Dynamic Media Image Production System API

batchSetImageField

最後更新: 2024年7月22日
  • 主題:

建立對象:

  • 開發人員
  • 管理員

設定一或多個影像資產的影像特定欄位。

語法

授權的使用者型別

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

參數

輸入(batchSetImageFields)

名稱類型必要說明
companyHandlexsd:string是包含影像資產之公司的控制代碼。
updatearraytypes:ImageFieldUpdateArray是影像欄位更新的陣列。

輸出(batchSetImageFields)

名稱類型必要說明
successCountxsd:int是已成功設定影像欄位的數量。
warningcountxsd:int是作業嘗試設定影像欄位時產生的警告數目。
errororcountxsd:int是作業嘗試設定影像欄位時產生的錯誤數目。
warningDetailArraytypes:AssetOperationFaultArray否與資產關聯的詳細資訊陣列,在作業嘗試套用更新時產生警告。
errorDetailArraytypes:AssetOperationFaultArray否與資產關聯的詳細資訊陣列,在操作嘗試套用更新時產生錯誤。

範例

此範例會在更新陣列中設定兩個影像欄位中的資料。 在陣列中,影像由其資產控點指定,並包含解析度(畫素)、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