文件Dynamic Media Image Production System API

renameAsset renameasset

Last update: Fri May 26 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
  • Admin

重新命名資產。

NOTE
此 renameFiles 舊版已棄用引數，並已從以下版本中移除： renameAsset. 虛擬檔案路徑會變更為符合新的資產名稱（保留副檔名），而實體檔案路徑則不受影響。 API使用者端在更新至新API版本時需要移除此引數的參考。

授權的使用者型別 section-cc27ad713c6d498b8f056850b20976f4

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
NOTE
使用者必須擁有資產的讀取和寫入存取權。

參數 section-ef95a994106841e0ab346dd4cf672258

輸入(renameAssetParam)

名稱
類型
必要
說明
companyHandle
xsd:string
是
資產所屬公司的控制代碼。
assetHandle
xsd:string
是
您要重新命名的資產的控制代碼。
newName
xsd:string
是
資產的新名稱。
validateName
xsd:boolean
是
如果 validateName 是 true 且資產型別需要唯一的IPS ID，則會檢查新名稱是否有全域唯一性，以及 renameAsset 如果錯誤不是唯一的，則會擲回錯誤。

輸出(renameAssetReturn)

IPS API未傳回此作業的回應。 請參閱「 」的說明 <ns1:validateName> 元素，以取得關於此元素的警告。

範例 section-a0ddffd62bec42e09069f22ceb486f8a

此程式碼範例會重新命名資產

請求

<ns1:renameAssetParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:assetHandle>24265|1|17061</ns1:assetHandle>
   <ns1:newName>My Newly Renamed Image</ns1:newName>
   <ns1:validateName>true</ns1:validateName>
   <ns1:renameFiles>true</ns1:renameFiles>
</ns1:renameAssetParam>

回答

無。

recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681